Google Mail Connector 25.3
Google Mail Connector Help

# Retrieve Information from a Single User

To retrieve messages from a single user, 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 (Single User), 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:

   Username | The user name to use to access Google Mail, when you want to retrieve data from a single user account.
   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]
       Username=user@gmail.com
       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 Connector Configuration Parameters.

Copyright 2025 Open Text
Version 25.3 | Last updated July 2025

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: Knowledge Discovery Google Mail Connector 25.3

Topic Title: Retrieve Information from a Single User