Note: 
  • Use and transfer of information received from Google APIs to any other app will adhere to Google API Services User Data Policy, including the Limited Use requirements.

  • In accordance with the Nintex Privacy Policy, Nintex Services do not retain any information obtained from third party services.

Google Directory

The Google Directory connector A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow actions and start events. is used to create connections for Google Directory actions and data lookups. Use Google Directory actions A tool for building the processes, logic, and direction within workflows. to create, update, and delete users, groups, and organizational units in Google Workspace, and to retrieve lists of users and groups.

Google Directory is a directory service developed by Google that allows you to perform administrative tasks on users, groups, and organizational units in Google Workspace.

For more information on Google Directory, see Google Workspace and Google Workspace Admin.

In the context of Nintex Automation Cloud, Google Directory is a connector A software component that allows seamless integration with third-party services, business applications, and content stores. Examples include Salesforce, Box, and Microsoft SharePoint. Connectors are used to create connections required for workflow actions and start events..

Create a Google Directory connection

Note: Your browser-stored credentials are accessed to create connections. Either clear credentials from browser memory or make sure the stored credentials are for the intended environment.

Create a connection from the connections page or from the action configuration panel when configuring the action. For information about creating connections and assigning permissions, see Manage connections.

Google Directory account requirements

  • Nintex Automation Cloud uses the Nintex Automation Cloud - Google Directory Connector to create Google Directory connections. This connection requires you to grant permissions to read and write all user and group data.
  • The account you use to create a connection for Google Directory is the account that has access to the Google Directory actions.

Create a Google Directory data lookup

Use the Google Directory data lookup to create a drop-down list of Google Directory groups or members of a group in a form. Each data lookup is configured for a specific account. You can create as many data lookups as you need. For more information on creating a data lookup and assigning permissions to it, see Data lookups.

For example, to allow users to select a specific group in a form, add a drop-down list of groups to the form using a Data lookup control A form control that allow users to select from a drop-down list that has values sourced from a third-party service.. The Data lookup control uses a Google Directory - Get groups data lookup to list the groups in a domain.

You can create a data lookup to:

  • Get groups: List all the groups in Google Directory.
  • Get members of a group: List all the members belonging to a specific group in Google Directory.

Google Directory data lookup fields

When you create a Google Directory data lookup, you can configure some additional fields to specify which tables, views, and stored procedures the data lookup should retrieve.

To access the data lookup fields, in the Add data lookup section, select the Connector and the Operation.

The following operations are available for the Google Directory connector:

  • Google Directory - Get groups

  • Google Directory - Get members of a group

Operation

Field or selection

Description

Google Directory - Get groups Domain Restricts the records retrieved to lists that include a specific domain. This field is optional. If you specify a Domain, the results are filtered according to the domain.
  Query Retrieves all groups using a query. This field is optional. If you specify a Query, the results are filtered according to the query parameters. Your query should be in the format of a query string search containing a field, operator and value. For more information, see the Google Directory API.
Example:
GET https://www.googleapis.com/admin/directory/v1/groups?domain=sales.com&customer=my_customer&maxResults=2
Google Directory - Get members of a group Group Restricts the records retrieved to lists that include a specific group. This field is optional. If you select a Group, the results are filtered according to the group selected.