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 https://console.cloud.google.com/projectcreate.

    Google Create Project page

  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.

Google Cloud Platform Dashboard notification for Create Project

Enable Your APIs

  1. Click Enable APIs and Services or Library.

    Google Console Enable APIs

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

  • Gmail API
Google API Library

Configure Your OAuth Screen

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

Google OAuth Screen
  1. From the Google APIs dashboard, click OAuth consent screen.

Choose your user type, either Internal or External.

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.
Google Console App Dashboard

Create Credentials

  1. Click Create Credentials or Credentials.
  2. Select OAuth client ID.
  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.
Google Console Create Credentials

Create a Google Integration

You can skip this step, if you have already created an Integration. You only need to create an Integration once.

  • Make sure you have added the redirect URI to the app you just created.
    • https://datastreams.us.nylas.com/connect/callback.
    • For EU regions, <https://datastreams.eu.nylas.com/connect/callback>
  1. Go to the Nylas dashboard and select Integration.
  2. Choose the Integration you want to create.
  3. Enter the client ID, client secret, and redirect URI.
Nylas dashboard showing the create Integration page

Create a Grant

You’ll need to grant an email access to the Integration you created.

  1. Go to the Nylas Dashboard and select Grants.
  2. Click Add Grant.
  3. Enter the email address you want to grant.

You’ll need to create a grant for each email you want to get data for.

Nylas dashboard opened to Grants page.

What's Next

Choose which provider you want to stream data to. You can learn more about the supported data types and connectors offered.