Gmail documentation: API guide, Authentication
A. Set up a Google Mail connection
Start establishing a connection to Google Mail in either of the following ways:
- From the Resources menu, select Connections. Then, click + Create connection at the top right.
– or – - While working in a new or existing integration, you can add an application to a flow simply by clicking Add source or Add destination/lookup.
In the resulting Application list, select Google Mail.
The Create connection pane opens with required and advanced settings.
B. Supply required Google Mail account information
At this point, you’re presented with a series of options for providing Google Mail authentication.
Name (required): Provide a clear and distinguishable name. Throughout integrator.io imports and exports, you will have the option to choose this new connection, and a unique identifier will prove helpful later when selecting among a list of connections that you’ve created.
Application (required, non-editable): A reminder of the app you’re editing.
Configure scopes (required): Scopes are permissions that the Gmail API defines to limit the access to your account. To select the scopes for this connection,
- Click the Configure scopes button.
- To access all of the scopes in the API, click the » button.
– or –
Check the scopes you want to add, and click the > button.
Configure your client id and secret (required): Check this box to reveal iClient options.
iClient (required): Select the iClient pair that stores the client ID and client secret provided to you by Google Mail. To add an iClient and configure your credentials, click the plus (+) button. Click the edit ( ) button to modify a selected iClient. Be sure to give the iClient a recognizable name for use in any other connections.
Callback URL (read-only): Copy this integrator.io callback URL to provide directions to Google Mail for where to go after authentication. (This URL should be whitelisted with the authorization server.)
Sign in to your Google API Console, and click Create project in your dashboard.
Describe your project and click Create.
From the console options, select OAuth consent screen at the left. Create a consent screen for internal or external users.
Set the Application type to Public, describe the application, and click Save.
Then, select Credentials from the console options. In the Credentials page, click + Create credentials > OAuth client ID.
Describe the new client ID. Under its Authorized redirect URIs, paste the Callback URL above. When you click Create, you are shown the client ID and secret for use in the Google Mail connection’s iClient pair.
C. Edit advanced Google Mail settings
Before continuing, you have the opportunity to provide additional configuration information, if needed, for the Google Mail connection.
Borrow concurrency from (optional): Select another connection from the list....
Concurrency level (optional): Up to 25 allowed....
D. Test the connection
Once you have configured the Google Mail connection, you have a couple options for continuing:
- Save & authorize – click this button to test the connection, commit the new connection so that it will be available to all integrations for your account (and applied to the current source or destination app, if you created it within a flow)
- Cancel – click to exit without saving any new changes
When you select Save & authorize, you are presented with a Google Mail form in a new browser window.
After signing in, review the permissions for the integration and click Allow.
The browser window closes, and the new connection is now successfully added to your account. It will be applied to the current source or destination app, if you created it within a flow. Otherwise, you may proceed to register the connection with an integration.
Comments
0 comments
Please sign in to leave a comment.