Version:
Only show these results:

Google App for Streams

In this guide, you'll setup a Google app, create your Integration, and Grant an account access to your Integration.

Before you create your application with Google there are a few things to keep in mind.

Internal or External Application

Decide if you want your application available to anyone or only users part of your organization.

Internal Application

Use internal users for Google account access for development or production applications that are internal only. Only users who have an account within your organization, @your-organization.com, can access the application.

When users from your organization authorize against your application they will not see the unverified application warning.

Use internal applications to skip the App Verification and Security Review process. If anyone outside your organization needs to verify against your application at any time, you will need to go through the Google security review.

Learn More

Learn more about Unverified apps at Google.

External Application

Use external users if you are creating a production app and will need to go through Google security verification. This option will allow users who are not in your organization to authenticate against your application.

When users from your organization authorize against your application they will see the unverified application warning.

External apps are limited to 100 accounts before verification.

Learn More

Learn more about Unverified apps at Google.

Create a Google App

  1. Go to the Google Cloud Console create project page.
    The Google Cloud Platform Console showing the "New project" dialog. The project details are filled out with demo information.

  2. Give your project a name.

  3. Select your project Organization and Location.

  4. It can take several minutes for the project to be created. Once complete, you'll return to the dashboard with Create Project notifications.
    A close-up of a Google Cloud Platform Console notification. The notification shows that an application has been created, and includes a link to select the project.

Enable your APIs

  1. Click Enable APIs and Services or Library.
    The Google Cloud Platform Console showing the "APIs and services" page. A mostly-empty graph of traffic is displayed.

  2. Enable the Gmail API. You can find the APIs using the search.

Configure your OAuth screen

You can configure your application's OAuth screen. This is the page users will see when they authenticate your application.

  1. From the Google APIs dashboard, click OAuth consent screen.
  2. Choose your user type, either Internal or External.
    The Google Cloud Platform Console showing the "OAuth consent screen" page.

Internal OAuth Screen

  1. Next, fill out the required OAuth consent information. For the Authorized domains use nylas.com.
  2. Save and Continue.
  3. Click Add or Remove Scopes. Select
    1. .../auth/userinfo.email
    2. .../auth/userinfo.profile
    3. openid
    4. gmail.readonly
  4. Review the Summary and make sure the information is correct for your application.

External OAuth Screen

  1. Next, fill out the required OAuth consent information. For the Authorized domains use nylas.com.
  2. Save and Continue.
  3. Click Add or Remove Scopes. Select
    1. .../auth/userinfo.email
    2. .../auth/userinfo.profile
    3. openid
    4. gmail.readonly
  4. At step 3, Test Users, you can skip this for now. We’ll go back and change the app to Production.
  5. Review the Summary and make sure the information is correct for your application.
  6. Click Back to Dashboard.
  7. Under the heading Publishing status, click Publish App. Publishing your app makes it so that you authorize users using the Nylas API instead of needing to add them one at a time to the Google test users. The app will show as unverified until you go through the Google Security Review.
    A close-up of the Google Cloud Platform "External app" dialog. The "Publishing status" and "User type" options are displayed.

Create credentials

  1. Click Create Credentials or Credentials.

  2. Select OAuth client ID.
    The Google Cloud Platform Console showing the "Credentials" page. The "Create credentials" drop-down list is expanded, and the "OAuth client ID" option is highlighted.

  3. Select Web Application as the Application Type.

  4. Give the application a name.

  5. Update Authorized redirect URIs to use:

    • <https://datastreams.us.nylas.com/connect/callback>
    • For EU regions, <https://datastreams.eu.nylas.com/connect/callback>
  6. Click Create.

  7. You’ll see your client ID and secret displayed in OAuth client created. Save this someplace safe. You’ll need these for your Nylas application.

Create a Google Integration

💡 Tip: You can skip this step if you've already created an integration.

Before you begin, make sure you've added the redirect URI to your new application:

  • U.S. region: https://datastreams.us.nylas.com/v3/connect/callback
  • E.U. region: https://datastreams.eu.nylas.com/v3/connect/callback

After you set your redirect URI, you can create your integration:

  1. Go to the Nylas Dashboard and select Integration.
  2. Choose the integration you want to create.
  3. Enter your client ID, client secret, and redirect URI.

The Nylas Dashboard showing the "Integrations" page. A Gmail integration is listed.

Create a Grant

First, you need to grant the email account access to your integration:

  1. Go to the Nylas Dashboard and select Grants.
  2. Click Add Grant.
  3. Enter the email address that you want to create a grant for.
  4. Repeat steps 2 and 3 for each email address you want to get data for.

The Nylas Dashboard opened to the Grants page.

What's Next

Choose which provider you want to stream data to:

You can also read about the supported data types and connectors Nylas offers.