# 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.

_FT_HTML5_bannerTitle.htm