Configure the OAuth consent screen | Google Workspace for Developers

When you use OAuth 2.0 for authorization, Google displays a consent screen to the user including a summary of your project, its policies, and the requested authorization scopes of access. Configuring your app's OAuth consent screen defines what is displayed to users and app reviewers, and registers your app so you can publish it later.

All apps using OAuth 2.0 require a consent screen configuration, but you only need to list scopes for apps used by people outside your Google Workspace organization.

Tip: If you don't know required consent screen information, you can use placeholder information prior to release.

  • Open the Google Cloud Console.
  • At the top-left, click Menu >
  • APIs & Services>OAuth consent screen.
  • Select the user type for your app, then click
  • Create.
  • Complete the app registration form, then click
  • Save and Continue.
  • If you're creating an app for use outside of your Google Workspace organization, click

    Add or Remove Scopes. Add and verify the authorization scopes required by your app, then clickSave and Continue.Note:Some scopes require additional reviews by Google. For apps used only internally by your Google Workspace organization, scopes aren't listed on the consent screen and use of restricted or sensitive scopes does not require further review by Google. For more details, see How to choose scopes for your app, below.
  • Under "Test users," click

    Add users. Enter your email address and any other authorized test users, then clickSave and Continue.
  • Review your app registration summary. Click

    Editto make changes, or clickBack to Dashboard.

How to choose scopes for your app

To define the level of access granted to your app, you need to identify and declare authorization scopes. An authorization scope is a OAuth 2.0 URI string that contains the Google Workspace app name, what kind of data it accesses, and the level of access.

For example, the scope below grants access to view, but not modify, Google Calendar settings:

For a list of available scopes, see OAuth 2.0 Scopes for Google APIs.

Scope categories

Some scopes require additional reviews and requirements because of the level or type of access they grant. Below are the types of scopes to consider:

Basic app verification required Additional app verification required Security assessment required
Non-sensitive scopes (recommended) Grant access only to limited data that's immediately relevant to a specific action.
Sensitive scopes Grant access to personal user data, resources, or actions.
Restricted scopes Grant access to highly-sensitive or extensive user data or actions.

Select the scopes your app needs

We recommend identifying the scopes you'll use before beginning development. This speeds up app configuration in Google Cloud Console and helps you prepare for any additional security reviews.

To select authorization scopes for your app:

  • While configuring your OAuth Consent Screen in the steps above, click
  • Add or remove scopes. A panel appears with a list of scopes for each API you've enabled in your Google Cloud project.
  • Select the scopes that provide the minimum level of access required by your app, then click
  • Update.
  • Review the scopes listed in each of the three sections: non-sensitive scopes, sensitive scopes, and restricted scopes. For any scopes listed in the "Your sensitive scopes" or "Your restricted scopes" sections, try to identify alternative non-sensitive scopes to avoid unnecessary additional reviews.
  • When your list of scopes is complete, click
  • Save and continue.

Next step

Create access credentials for your app.

Source: Google Developers

Related Articles