Google Mail

The Google Mail 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 Mail actions and data lookups. Use Google Mail actions A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. 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 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.. 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

  1. From Google Admin, go to Security>API controls.
  2. On the App access control page, click Manage third-party app access in the Overview section.
     
  3. Click Change access next to the Nintex Connector - Mail app.
     
  4. In the Change access dialog, select Trusted: Can access all Google services and then click Change.
     

Create a Google Mail data lookup

Use the Google Mail connector to create a data lookup to retrieve data from Google Mail. Data lookups 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 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.

Once you've created the data lookup, you can use it in a Data lookup form control A form control that allow users to select from a drop-down list that has values sourced from a third-party service.. to populate the drop-down list field on your form.

You can create a data lookup 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 lookup fields

When you create a Google Mail data lookup, you can configure additional fields.

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 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	Email	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	Email	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 lookup 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	Email	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 lookup 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 Google Mail - Get threads 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.