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 Mail - Get labels

Use the Google Mail - Get labels action A tool for building the processes, logic, and direction within workflows. Actions are the steps the workflow performs to complete a process. to retrieve a list of all the labels in a user's mailbox.

For more information about 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., go to Google Mail.

Before you begin: 

Jump to:

Configure the Google Mail - Get labels action

  1. Add the action to the workflow and open the action configuration panel. For more information, see Add an action to the workflow.

  1. Select a Connection. If you do not have a connection, see Add a connection.
  1. Specify an Email address for the user for whom you want to retrieve labels.
  2. Create or select a variable for the output.

Google Mail - Get labels action fields, buttons, and settings

Section

Field

Description

Variable types
(unlabeled) Connection Credentials and other settings that enables workflows to communicate with external systems, services, or applications. It's required to pass data between the workflow and the indicated service, which could be a cloud service, business application, or content store. The Google Mail connection to use to retrieve labels from the user's mailbox.

To refresh the available connections, click .

 (n/a)
  Email The email address of the user for whom you want to retrieve labels. The default value "me" shows the authenticated user. If you want to select another user, insert a variable in the Email field. When using a variable, use the user's email address. Text, Decimal, Integer, Boolean, DateTime, Collection
Output Labels Stores the result of the action as an object. The following values are retrieved:
  • ID: (Text) The unique ID of the label.
  • Name: (Text) The display name of the label.
  • Type: (Text) The owner type for the label. User labels are created by the user, can be modified and deleted by the user, and can be applied to any message or thread. System labels are internally created and cannot be added, modified, or deleted. System labels can be applied to, or removed from, messages and threads under some circumstances but this is not guaranteed. For example, users can apply and remove the INBOX and UNREAD labels from messages and threads, but cannot apply or remove the DRAFTS or SENT labels from messages or threads.
 Object