Prerequisites for Creating a Connection

To use the Google Gmail Adapter, you must first have access to the Google Gmail API for your integration. To access the Google Gmail API, you must create a Google project.

To create a Google Gmail project:

1. Log in to your Google account and access the Google Gmail Developer Console at https://console.developers.google.com.
2. In the Title bar of the Google Cloud Platform page, click the Select a project drop-down list.
3. Select an existing project to use or create a new project.

   Note:

   If you create a new project, ensure that the project is selected from the drop-down list after saving the new project. You can view the project’s dashboard only if you select the project.
4. Click ENABLE APIS AND SERVICES. Alternatively, click Library in the left navigation pane.
   The API Library page opens.
5. In the Search field, enter Gmail API, and then select Gmail API from the search results.
6. In the Gmail API window, click MANAGE. Alternatively, for a new project, click ENABLE.
7. In the left navigation pane, click Credentials.
8. At the top of the Credentials window, click CREATE CREDENTIALS, and then choose OAuth client ID.
9. If you created a new project in step 3, perform the following additional configurations. Otherwise, proceed to step 10.
   1. In the Create OAuth client ID window, click CONFIGURE CONSENT SCREEN.
   2. In the OAuth consent screen window, select External as the user type, and click CREATE.
   3. In the App information window, enter the necessary information in the required fields, then click SAVE AND CONTINUE.
   4. Go back to the Credentials window.
   5. Click Credentials in the left navigation pane.
10. In the Application type field, select Web Application from the drop-down list.
11. Enter a name for the OAuth Client ID in the Name field.
12. Scroll to the Authorized redirect URIs section, and click ADD URI.
13. Enter the following URL in the URIs field.

    Note:

    If you don't know the following information, check with your administrator:

    • If your instance is new or upgraded from Oracle Integration Generation 2 to Oracle Integration 3.
    • The complete instance URL with the region included (required for new instances).

    For Connections…	Include the Region as Part of the Redirect URL?	Example of Redirect URL to Specify…
    Created on new Oracle Integration 3 instances	Yes.	https://OIC_instance_URL.region.ocp.oraclecloud.com/icsapis/agent/oauth/callback
    Created on instances upgraded from Oracle Integration Generation 2 to Oracle Integration 3	No. This applies to both: New connections created after the upgrade Existing connections that were part of the upgrade	https://OIC_instance_URL.ocp.oraclecloud.com/icsapis/agent/oauth/callback

14. Click Create.
    You receive a confirmation message that the OAuth Client has been created.
15. In the resulting dialog, copy the Client ID and Client Secret. Note the client ID and secret values because you’ll need these values when configuring the Gmail connection on the Connections page.
16. Click OK.
17. Return to the Credentials window. The OAuth 2.0 client ID that you created is listed under the OAuth 2.0 Client IDs section.

Note:

Before creating a Gmail connection, you must upload the trusted Google Gmail public certificate to Oracle Integration. The trusted Google Gmail public certificate can be downloaded from https://gmail.com. Rename the GoogleCertificate.txt file extension to .cer. See Certificate Errors to obtain the trusted certificate from Google and Upload a Certificate to Connect with External Services to upload the certificate.