Adding a Gmail application

Enable the Gmail API

1. Navigate to the Google Cloud™🡥 website.
2. Log in with your account.
3. Create a new project or use an existing project. Refer to Creating and managing projects🡥 for more information.
4. Click Enable APIs and services on the main dashboard screen.
5. Click the Gmail API card.
6. Click the Enable button.

Create OAuth consent screen

1. On the left side menu in APIs & Services, go to OAuth consent screen.
2. Select the External option, and click the Create button.
3. Name your app, such as Gmail connection.
4. Select your email on the User support email combination box.
5. Optional: Upload an image file to become your application's logo.
6. Enter URLs of your application's home page, public privacy policy, and terms of service.
7. Set authorized domains, if you are using a custom domain.
8. Add your email address in Developer contact information and click Save and continue.
9. On the Scopes tab, click Add or remove scopes.
   1. On Filter field, search Gmail.
   2. Select all Gmail API checkbox.
   3. Click Update button.
10. Click Save and continue once you are done configuring the scopes.
11. Optional: On the Test users tab, you can add users to your testing app.
12. Click Save and continue.

Create credentials

1. Click Back to dashboard.

2. On the left side menu in APIs & Services, go to Credentials.

3. Click Create credentials > OAuth client ID.

4. Select the Web application option in the Application type combination box.

5. Name your application, such as Gmail provider.

6. In Authorized JavaScript origins, click Add URI. This address is the Fully Qualified Domain Name (FQDN) to your IBM RPA's API, such as https://example.com:7790, where 7790 is the port that is used by the IBM RPA's API.

7. In Authorized redirect URIs, click Add URI. This address is the Fully Qualified Domain Name (FQDN) to your IBM RPA's API, such as https://example.com:7790, where example.com is the FQDN and 7790 is the port used by the IBM RPA's API, with the OAuth2 specifications /integration/oauth2. Following are examples of valid URLs with the OAuth2 specifications:

   • https://example.com:7790/integration/oauth2
   • https://api.example.com/integration/oauth2 if you have configured the api subdomain as your API domain forwarding to the appropriate API port.

   🛈 Remember: Replace the URL with the appropriate server API URL.

8. Click Create to create the credentials.

After you create the credentials, you should be prompted with the Client ID and Client secret.

If you were unable to see it, follow these steps:

1. Navigate to Google Cloud Developers 🡥.
2. In the left side menu, go to Credentials.
3. Under OAuth 2.0 Client IDs, look for your newly created credentials and click it.
4. The Client ID and Client secret are listed on the right.

Add the application

1. Log in to IBM RPA Control Center.

2. Click Applications on the main menu.

3. Click Add application.

4. In the Name field, enter the application name.

5. In the Description field, enter the application description.

6. In the Application tags field, select a tag to identify the application. The tag is used to filter applications.

7. Click Next.

8. In the Client ID field, enter your Client ID.

9. In the Client Secret field, enter your Client secret.

10. In the Redirect URL field, enter the Redirect URL you have previously configured in the Gmail app, such as https://api.example.com/integration/oauth2.

11. In the Authorization URL field, enter https://accounts.google.com/o/oauth2/v2/auth .

12. In the Authorization Template Parameter field, enter the following code snippet:

    prompt=consent&access_type=offline&client_id={clientId}&response_type=code&redirect_uri={redirectUri}
    

    🛈 Remember: IBM RPA automatically replaces the values of {clientId} and {redirectUri} with the values defined in Client ID and Redirect URL, respectively.

13. In the Token URL field, enter https://www.googleapis.com/oauth2/v4/token .

14. In the API URL field, enter https://gmail.googleapis.com/ .

15. In the Scopes field, enter:

    https://www.googleapis.com/auth/userinfo.email https://mail.google.com/
    

16. Click Next.

17. Review the summary of the data that you entered, and click Add.