IMAP Connector 12.12

# Retrieve Data from Gmail

The behavior of the IMAP Connector can be modified to work with the custom IMAP implementation used in the Google Gmail service.

To create a fetch task to retrieve messages from Gmail, follow these steps.

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, set the following parameters.

   `ImapServerName` | The name or IP address of the IMAP server. You must set this parameter to `imap.gmail.com`. Use this server name even if you want to access a Google Apps business account that has its own domain. The IMAP Connector host must have access to Google’s `8.8.8.8` and `8.8.4.4` Name Servers to ensure that changes to Gmail IP addresses are tracked. This is a requirement imposed by Google.
   `SSLConfigSection` | The name of a section in the configuration file that contains the settings required to communicate with the IMAP server over SSL. The section containing SSL settings might look like this:
       [SSL]
       SSLMethod=SSLV23
       SSLCheckCommonName=FALSE
       SSLCheckCertificate=FALSE
   `ImapServerSSLPort` | The port to use for the SSL connection.
   `UserName` | The user name required to access the IMAP server.
   `OAuth2SitesFile` | The file that contains the OAuth details to use. This file must be generated by Micro Focus on a case-by-case basis. For more information, contact Micro Focus Technical Support.
   `OAuth2SiteName` | A string that identifies the site details in the file specified by `OAuth2SitesFile`.
   `AllowFallbackFromOauth` | A Boolean that specifies whether the connector resorts to normal IMAP authentication if OAuth fails. To use the IMAP Connector with Gmail, set this parameter to `False`.
   `ConvertMetadataToUTF8` | A Boolean that specifies whether to save metadata in UTF8 format. Set this parameter to `True`.
   `IsGmail` | A Boolean that optimizes the connector for Gmail. Set this parameter to `True`.

2. You can set additional parameters to specify how the connector retrieves information. For a complete list of parameters that you can use, refer to the IMAP Connector Reference.

3. Save and close the configuration file.

© Copyright 2022 Micro Focus or one of its affiliates
Version 12.12 | Last updated June 2022

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 swpdl.idoldocsfeedback@microfocus.com.

We appreciate your feedback!

Product: IDOL IMAP Connector 12.12

Topic Title: Retrieve Data from Gmail