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 OpenText on a case-by-case basis. For more information, contact OpenText 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.