Gmail

The Gmail 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 Gmail actions and data sources. Use Gmail 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 Gmail.

Create a Gmail connection

You can create connections from the Automate or Designer page.

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 Gmail data source

Use the Gmail connector to create a data source to retrieve data from Gmail. 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 Gmail. Once you've created the data source, you can use it in a Data lookup form control to populate the drop-down list field on your form. For information about data sources, see Data sources.

When you configure the data source for the Gmail connector, you can select one of the following operations:

  • 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

The table below describes the additional configuration fields required for the Gmail operations.

Section

Field or selection

Description

Add new Operation Displays the operations available for the selected Connector. Depending on the selection the following fields are displayed:
  • Gmail - Get labels:
    • Email: Type the email address of the user you want to retrieve a list of labels for. Using 'me' will use the authenticated user's default email account.
  • Gmail - 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 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 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 Gmail - Get messages action.
  • Gmail - 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 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 Gmail - Get threads action.
    • Labels:Restricts the records retrieved to threads that include labels such as INBOX, SENT, SPAM, TRASH.
      Not sure what this is supposed to do?