Scopes

public final class Scopes extends Object

OAuth 2.0 scopes for use with Google Play services. See the specific client methods for details on which scopes are required.

Constant Summary

String APP_STATE Scope for using the App State service.
String CLOUD_SAVE Scope for using the CloudSave service.
String DRIVE_APPFOLDER Scope for accessing appfolder files from Google Drive.
String DRIVE_FILE Scope for access user-authorized files from Google Drive.
String EMAIL OAuth 2.0 scope for accessing user's Google account email address.
String FITNESS_ACTIVITY_READ Scope for read access to activity-related data types in Google Fit.
String FITNESS_ACTIVITY_READ_WRITE Scope for read/write access to activity-related data types in Google Fit.
String FITNESS_BODY_READ Scope for read access to biometric data types in Google Fit.
String FITNESS_BODY_READ_WRITE Scope for read/write access to biometric data types in Google Fit.
String FITNESS_LOCATION_READ Scope for read access to location-related data types in Google Fit.
String FITNESS_LOCATION_READ_WRITE Scope for read/write access to location-related data types in Google Fit.
String FITNESS_NUTRITION_READ Scope for read access to nutrition data types in Google Fit.
String FITNESS_NUTRITION_READ_WRITE Scope for read/write access to nutrition data types in Google Fit.
String GAMES Scope for accessing data from Google Play Games.
String PLUS_LOGIN This constant was deprecated. We recommend switching to PROFILE scope to get the one-tap sign-in experience. See Getting Profile Information. Your app will get much higher sign-in completion rate by switching to profile scopes because of the streamlined user experience. And your existing users with PLUS_LOGIN grant will not be asked to sign-in again.

If you really need user's age range and locale information (which is the only additional information you can get from PLUS_LOGIN as of September 2016), use below scopes in addition to PROFILE:

  • //www.googleapis.com/auth/profile.agerange.read
  • //www.googleapis.com/auth/profile.language.read
See also Android Plus API Deprecation Notes.
String PLUS_ME This scope was previously named PLUS_PROFILE.
String PROFILE OAuth 2.0 scope for accessing user's basic profile information.

Inherited Method Summary

Constants

public static final String APP_STATE

Scope for using the App State service.

Constant Value: "//www.googleapis.com/auth/appstate"

public static final String CLOUD_SAVE

Scope for using the CloudSave service.

Constant Value: "//www.googleapis.com/auth/datastoremobile"

public static final String DRIVE_APPFOLDER

Scope for accessing appfolder files from Google Drive.

Constant Value: "//www.googleapis.com/auth/drive.appdata"

public static final String DRIVE_FILE

Scope for access user-authorized files from Google Drive.

Constant Value: "//www.googleapis.com/auth/drive.file"

public static final String EMAIL

OAuth 2.0 scope for accessing user's Google account email address.

Constant Value: "email"

public static final String FITNESS_ACTIVITY_READ

Scope for read access to activity-related data types in Google Fit. These include activity type, calories consumed and expended, step counts, and others.

Constant Value: "//www.googleapis.com/auth/fitness.activity.read"

public static final String FITNESS_ACTIVITY_READ_WRITE

Scope for read/write access to activity-related data types in Google Fit. These include activity type, calories consumed and expended, step counts, and others.

Constant Value: "//www.googleapis.com/auth/fitness.activity.write"

public static final String FITNESS_BODY_READ

Scope for read access to biometric data types in Google Fit. These include heart rate, height, and weight.

Constant Value: "//www.googleapis.com/auth/fitness.body.read"

public static final String FITNESS_BODY_READ_WRITE

Scope for read/write access to biometric data types in Google Fit. These include heart rate, height, and weight.

Constant Value: "//www.googleapis.com/auth/fitness.body.write"

public static final String FITNESS_LOCATION_READ

Scope for read access to location-related data types in Google Fit. These include location, distance, and speed.

Constant Value: "//www.googleapis.com/auth/fitness.location.read"

public static final String FITNESS_LOCATION_READ_WRITE

Scope for read/write access to location-related data types in Google Fit. These include location, distance, and speed.

Constant Value: "//www.googleapis.com/auth/fitness.location.write"

public static final String FITNESS_NUTRITION_READ

Scope for read access to nutrition data types in Google Fit.

Constant Value: "//www.googleapis.com/auth/fitness.nutrition.read"

public static final String FITNESS_NUTRITION_READ_WRITE

Scope for read/write access to nutrition data types in Google Fit.

Constant Value: "//www.googleapis.com/auth/fitness.nutrition.write"

public static final String GAMES

Scope for accessing data from Google Play Games.

Constant Value: "//www.googleapis.com/auth/games"

public static final String PLUS_LOGIN

This constant was deprecated.
We recommend switching to PROFILE scope to get the one-tap sign-in experience. See Getting Profile Information. Your app will get much higher sign-in completion rate by switching to profile scopes because of the streamlined user experience. And your existing users with PLUS_LOGIN grant will not be asked to sign-in again.

If you really need user's age range and locale information (which is the only additional information you can get from PLUS_LOGIN as of September 2016), use below scopes in addition to PROFILE:

  • //www.googleapis.com/auth/profile.agerange.read
  • //www.googleapis.com/auth/profile.language.read
See also Android Plus API Deprecation Notes.

OAuth 2.0 scope for accessing the user's name, basic profile info and Google+ profile info.

When using this scope, your app will have access to:

  • the user's full name, profile picture, Google+ profile ID, age range, and language
  • any other publicly available information on the user's Google+ profile
Constant Value: "//www.googleapis.com/auth/plus.login"

public static final String PLUS_ME

This scope was previously named PLUS_PROFILE.

When using this scope, it does the following:

  • It lets you know who the currently authenticated user is by letting you replace a Google+ user ID with "me", which represents the authenticated user, in any call to the Google+ API.
Constant Value: "//www.googleapis.com/auth/plus.me"

public static final String PROFILE

OAuth 2.0 scope for accessing user's basic profile information.

When using this scope, it does the following:

  • It requests that your app be given access to the authenticated user's basic profile information.
  • It lets you know who the currently authenticated user is by letting you replace a Google+ user ID with "me", which represents the authenticated user, in any call to the Google+ API.
  • It lets your web app access over-the-air Android app installs.
Constant Value: "profile"