Google Mail Connector 24.3

# Retrieve Information from G Suite Users

To retrieve messages from multiple users in a G Suite domain, create a new fetch task by following these steps. The connector runs each fetch task automatically, based on the schedule that is configured in the configuration file.

To create a new Fetch Task

1. Stop the connector.
2. Open the configuration file in a text editor.

3. In the `[FetchTasks]` section of the configuration file, specify the number of fetch tasks using the `Number` parameter. If you are configuring the first fetch task, type `Number=1`. If one or more fetch tasks have already been configured, increase the value of the `Number` parameter by one (1). Below the `Number` parameter, specify the names of the fetch tasks, starting from zero (0). For example:

       [FetchTasks]
       Number=1
       0=MyTask

4. Below the `[FetchTasks]` section, create a new TaskName section. The name of the section must match the name of the new fetch task. For example:

       [FetchTasks]
       Number=1
       0=MyTask

       [MyTask]

1. In the new section, ensure that you have set the parameters required to authenticate with Google Mail. The OAuth configuration tool (described in Configure OAuth Authentication (G Suite)) creates a file that contains these parameters, and you can include them in the connector's configuration file using the following syntax:

       [MyTask] < "oauth.cfg" [OAUTH]

   For more information about including parameters from another file, see Include an External Configuration File

2. In the new section, set the following configuration parameters:

   GSuiteDomain | The domain (that is associated with G Suite) that you want to retrieve data from.
   GSuiteDomainAdmin | The e-mail address of a domain administrator for the G Suite domain. The connector uses this account to retrieve user information.
   GSuiteUsers | (Optional) A list of e-mail addresses for the user accounts that you want to synchronize. Use this parameter to synchronize a specific set of user accounts.
   MappedSecurity | (Optional) To add Access Control Lists (ACLs) to IDOL documents, and protect your IDOL documents with mapped security, set this parameter to `TRUE`.
   ProxyHost | (Optional) The host name or IP address of the proxy server to use to access Google Mail
   ProxyPort | (Optional) The port of the proxy server to use to access Google Mail.
   SSLConfig | The name of the section in the configuration file that contains the SSL settings to use to access Google Mail.
   UserAgent | The value to use for the `User-Agent` header in requests sent to the repository. OpenText recommends that you set the user-agent to a value that includes "gzip". This improves performance because Google Mail compresses its responses with GZIP compression.

   For Example:

       [MyTask]
       GSuiteDomain=my-gsuite-domain.com
       GSuiteDomainAdmin=admin@my-gsuite-domain.com
       MappedSecurity=TRUE
       ProxyHost=10.0.0.1
       ProxyPort=8080
       SSLConfig=SSL
       UserAgent=autn:netlib/2.0 gzip

       [SSL]
       SSLMethod=NEGOTIATE

3. Save and close the configuration file. You can now start the connector.

   For more information about the configuration parameters that are available in Google Mail Connector, see TaskName Configuration Parameters.

Copyright 2024 Open Text
Version 24.3 | Last updated June 2024

Send documentation feedback

Close

Send documentation feedback

To send feedback using your default email client, open an email window.

Otherwise, send your feedback and the information below to MFI-swpdl.idoldocsfeedback@opentext.com.

We appreciate your feedback!

Product: IDOL Google Mail Connector 24.3

Topic Title: Retrieve Information from G Suite Users