Google Workspace

learn how to connect engini to google workspace using engini’s google workspace activities, you can check for new sent emails, send emails and include attachments seamlessly to get started with the gmail app, create an free account at google com or use your organizational google mailbox getting started with google workspace prerequisites an google workspace account add a connection to google workspace in engini enter your engini account at https //app engini io/ navigate to connections page by clicking on the connections on the left sidebar or by clicking https //app engini io/connections click on the add connection option located at the topbar choose google workspace option from the available applications enter the details in the “add connection” form note there are two different authentication methods available, and the required fields differ depending on the option you choose please follow the relevant instructions based on your selected method oauth2 this method uses a predefined authentication flow you don’t need to provide a client id or client secret, you simply sign in using your account connection name – enter unique identifier for the connection within engini authentication method – select oauth2 fields automatically populated post connecting to a google account include email used as the primary email address associated with the account display name employed when utilizing the email sending activity, enabling customized sender names access token a token for authorization to access google services click on the “sign in with google” button sign into your google account click on the save button to save the connection custom oauth2 this method requires you to configure your own oauth2 credentials you must provide both a valid client id and client secret obtained from your google cloud console project connection name – choose a unique identifier for the connection within engini authentication method – select custom oauth2 when connecting to google services using a custom oauth client to learn more about this authentication, enter here client id – enter the client id from the oauth 2 0 credentials in the google cloud project client secret – enter the client secret from the same set of oauth 2 0 credentials in the google cloud project access token – automatically populated post connecting to a your google account refresh token automatically populated post connecting to a your google account sign in with google – click sign in with google and log in with the google account used to create the project in google cloud this ensures access to the correct oauth credentials and permissions click on the save button to save the connection actions get group this activity retrieves information about a specified google workspace group, including details such as the group’s email address and membership settings group id – enter the group id of the group you want to get get user this activity retrieves details about a specified user, including information such as their email address, account status, and organizational unit within google workspace user key – enter the user’s primary email, alias email, or unique user id to specify which user you want to retrieve projection – choose the level of detail for the user data you want to retrieve (basic or full) view type – choose the scope of data visibility, such as admin only information (admin view) or publicly available data within the domain (domain public) get a user’s license by product sku this activity retrieves a user’s license details for a specific product using the product id and sku product id – enter the unique identifier of the product for which you want to retrieve the license sku id – enter the sku (stock keeping unit) associated with the product to specify the license user id – enter the unique user id for the user whose license you want to retrieve get group members this activity retrieves the list of members belonging to a specified group group id – enter the unique identifier of the group whose members you want to retrieve include derived membership – choose whether to include indirect members, such as those from nested groups (true or false) roles – enter the specific roles to filter members by their roles within the group owner, member, manager) add filters the filter option allows you to specify conditions to narrow down the retrieved group members based on certain fields top n – you can set the maximum number of group members that will be returned during one workflow cycle (default = all members) get groups this activity retrieves a list of groups in google workspace, providing details such as group names, email addresses, and descriptions include derived membership – choose whether to include indirect members, such as those from nested groups (true or false) customer – enter the customer id to specify which customer account’s groups you want to retrieve domain – enter the domain name to retrieve all groups associated with that domain get users this activity retrieves a list of users from a specified domain or customer account customer – enter the unique customer id to retrieve users from a specific google workspace account domain name – enter the domain name to retrieve users associated with that domain projection – choose the level of detail for the user data you want to retrieve (basic or full) order by – choose the field by which to sort the users, (email, family name, given name) sort order – choose the sort order (ascending or descending) show deleted – choose whether to include deleted users in the results (true/false) view type – choose the scope of data visibility, such as admin only information (admin view) or publicly available data within the domain (domain public) add filters – you can add filters to retrieve only the users that meet specific conditions (such as by address, country, postal code, email, or other user attributes) top n – you can set the maximum number of users that will be returned during one workflow cycle (default = all users) list all users assigned licenses this activity retrieves a list of users who have been assigned licenses for a specific product customer id – enter the unique customer id to retrieve the list of users for that customer product id – enter the product id to filter only the users who have a license for that specific product list all users assigned licenses for product sku this activity retrieves a list of users who have have licenses for a specific version of a product company id enter the unique id of the company to specify which organization users to retrieve product id – enter the unique id of the product to retrieve users with licenses for that specific product sku id – enter the sku (stock keeping unit) id, which represents the specific version or type of the product add member to group this activity adds a new member to a specified google workspace group group id – enter the unique id of the group where you want to add the new member field s allows you to specify additional details for the new group member (email, role, status ,etc ) assign a license this activity allows to assigns a specific product license to a user within google workspace product id – enter the unique id of the product sku id – enter the sku id to specify the version of the product user id – enter the user’s email or id to assign the license create group this activity creates a new google workspace group with specific settings add field allows you to add additional information or properties for the group you’re creating admincreated – indicates if the group was created by an admin noneditablealiases\[] – provides a list of alternate email addresses associated with the group that cannot be changed aliases – enter alternate email addresses for the group description – enter a description for the group directmemberscount – shows the number of direct members in the group email – enter the group’s email address etag – a unique identifier for the group (used internally) id – the unique id for the group (automatically generated) kind – specifies the type of group name – enter the name of the group create user this activity creates a new user in google workspace primary email – enter the user’s primary email address password – set a password for the user familyname – enter the user’s last name givenname – enter the user’s first name add field – allows you to add extra details or attributes for the user you are creating, such as emails, gender, externalids, phones, addresses, and organizations there are many other attributes available to further customize the user’s profile emails – add extra email addresses for the user gender – specify the user’s custom gender identity externalids – add external ids associated with the user phones – add phone numbers for the user addresses – provide physical addresses for the user organizations – specify the user’s organization details update group this activity allows you to update the details of an existing group in google workspace group id – enter the unique id of the group you want to update fields – allows you to include additional properties or information when updating a group admincreated – specify whether the group was created by an admin aliases – update the alternate email addresses (aliases) for the group description – update the group’s description directmemberscount – shows the updated number of direct members in the group email – update the group’s email address etag – a unique identifier for the group (used internally) kind – the type of group (used internally) name update the group’s name noneditablealiases – lists aliases that cannot be edited update user this activity allows you to update the details of an existing user in google workspace id – enter the unique id or email of the user you want to update fields – allows you to add additional fields to update specific details about the user addresses – update the user’s physical addresses, such as home or work agreedtoterms – specify whether the user has agreed to the terms of service aliases – add or update alternate email addresses for the user changepasswordatnextlogin – require the user to change their password upon their next login emails – update the user’s email addresses customschema – add or modify custom fields for the user based on your organization’s specific needs externalids – add or update external ids linked to the user gender – update the user’s gender information phones – add or update the user’s phone numbers organizations – update the user’s organization details delete group this activity permanently removes a group from the google workspace domain group key – enter the group’s email address or unique group id to specify which group to delete delete user this activity permanently removes a user from the google workspace domain user key – enter the user’s primary email address, alias email, or unique user id to identify which user to delete remove a license this activity removes a product license from a specified user in google workspace product id – enter the unique id of the product from which you want to remove the license sku id – enter the sku (stock keeping unit) id to specify the version of the product license to be removed user id – enter the unique id or email of the user whose license you want to remove remove member from group this activity removes a specified member from a google workspace group group id – enter the unique id of the group from which you want to remove the member member id – enter the unique id or email of the member you want to remove from the group initialize object array this activity initializes an object array in google workspace and stores a single structured entry based on the selected object type (e g addresses, emails) variable name enter the name of the variable that will hold the initialized object array this name will be used throughout the workflow whenever you refer to this object array object element type this field defines the type of data the array will store, such as addresses and emails the selected type determines the structure of the array and its use in subsequent actions fields to view the add field options, you must first select an object in the object element type field only after choosing an object, the system knows which fields belong to it, and then the relevant fields will appear in the list without selecting an object first, the add field button will show no available fields append to object array this activity adds an item to an existing array of objects in google workspace variable – select the array where you want to add the new item