-
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 Mail
The Google Mail connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores. is used to create connections for Google Mail actions and data sources. Use Google Mail actions A tool for building the processes, logic, and direction within workflows. to get messages, threads, and labels, and to delete a message from a user's mailbox in Google Mail. In the context of Nintex Automation Cloud, Google Mail is a connector Service used to define a connection required for associated actions and start events. Examples include Salesforce and Box. Method of integration to cloud services, business applications and content stores.. Google Mail is an email service developed by Google that allow users to access Google Mail on the web. Google Mail uses third-party programs that synchronize email content through POP or IMAP protocols. You can also chat, make voice or video calls, and stay on top of project work with shared files and tasks. For more information, see Google Mail.
Create a Google Mail 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 Mail account requirements:
- Nintex Automation Cloud uses the app Nintex Automation Cloud - Google Mail Connector to create Google Mail connections. This app requires you to grant permissions to read, compose, send, delete mail and view your email messages and settings.
- The account you use to create a connection for Google Mail is the account that has access to the Google Mail actions.
-
Before you create your connection, you must configure Nintex Connector - Mail as a trusted app in your Google Workspace to comply with Google's security restrictions. Steps to configure the Nintex Connector - Mail app as a trusted app in Google Workspace
- From Google Admin, go to Security>API controls.
- On the App access control page, click Manage third-party app access in the Overview section.
- Click Change access next to the Nintex Connector - Mail app.
- In the Change access dialog, select Trusted: Can access all Google services and then click Change.
Create a Google Mail data source
Use the Google Mail connector to create a data source to retrieve data from Google Mail. Data sources are useful when you want to use a form in a workflow, and you want to populate a drop-down list in your form with data from Google Mail. Each data source is configured for a specific account. You can create as many data sources as you need. For more information on creating a data source and assigning permissions to it, see Data sources.
Once you've created the data source, you can use it in a Data lookup form control A form control that allows users to select from a drop-down list of values that have been fetched from a third-party service.. to populate the drop-down list field on your form.
You can create a data source to:
- Get labels - Use this operation if you want to retrieve a list of all labels from a user's mailbox.
- Get messages - Use this operation if you want to retrieve a list of all the messages in a user's mailbox.
- Get threads - Use this operation if you want to retrieve a list of all the message threads in a user's mailbox.
Data source fields
When you create a Google Mail data source, you can configure additional fields.
To access the data source fields, in the Add data source section, select the Connector and the Operation.
The following operations are available for the Google Mail connector:
-
Google Mail - Get labels
-
Google Mail - Get messages
-
Google Mail - Get threads
The configuration fields displayed depend on the operation selected.
Operation |
Field or selection |
Description |
---|---|---|
Google Mail - Get labels |
|
Type the email address of the user for whom you want to retrieve a list of labels. Using 'me' will use the authenticated user's default email account. |
Google Mail - Get messages |
|
Type the email address of the user for whom you want to retrieve messages. Using 'me' will use the authenticated user's default email account. |
Item limit | Select the value for the maximum number of messages to be retrieved. | |
Query | Type a query to retrieve messages. This field is optional. If you specify a Query, the data source will only retrieve messages matching the specified query. Supports the same query format as the Gmail search box. Your query should contain a field, operator and value. For more information see the Gmail API. For example, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". | |
Page token |
Retrieves the next page of messages. Use the Page token output from a previous Google Mail - Get messages action. How do I get the page token from Google Mail?
You can use the Next page token output of a previous Google Mail - Get messages action
to retrieve the next page of results.
|
|
Google Mail - Get threads |
|
Type the email address of the user for whom you want to retrieve message threads. Using 'me' will use the authenticated user's default email account. |
Item limit | Select the value for the maximum number of message threads to be retrieved. | |
Query | Type a query to retrieve message threads. This field is optional. Supports the same query format as the Gmail search box. If you specify a Query, the data source will only retrieve message threads matching the specified query. Your query should contain a field, operator and value. For example, "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread". | |
Page token |
Retrieves the next page of message threads. Use the Page token output from a previous Email: Type the email address of the user for whom you want to retrieve messages. Using 'me' will uus action. How do I get the page token from Google Mail?
You can use the Next page token output of a previous Google Mail - Get messages action
to retrieve the next page of results.
|
|
Labels | Restricts the records retrieved to threads that include labels such as INBOX, SENT, SPAM, TRASH. |