Add Scopes to your project
Written by Sukhmanjeet Kaur
Updated at July 29th, 2025
Scopes define which permissions you need from a user's Google account to provide your service or collect information.
- On the Scopes page, click ADD OR REMOVE SCOPES.
- Select the Scopes from the list of APIs.
If you are unable to locate any Scopes, you can manually search for them. Perform the following steps to manually add the scopes.- Under Manually add scopes, enter the following full scope string in the text box.
- https://www.googleapis.com/auth/userinfo.email,
- https://www.googleapis.com/auth/gmail.readonly,
-
https://www.googleapis.com/auth/gmail.metadata
As a result of adding the above scopes, the metadata of emails in the shared inbox can be retrieved.
- Click ADD TO TABLE.
- Under Manually add scopes, enter the following full scope string in the text box.
- After adding the scopes to your project, click UPDATE.
A new page appears where you can see a list of all your selected scopes. - Click SAVE AND CONTINUE.
Below is a summary of the added scopes to your project.
| Scope | Purpose |
| https://www.googleapis.com/auth/userinfo.email | This scope is required to view the user's mail address. |
| https://www.googleapis.com/auth/gmail.readonly | This scope is required to view the email address and settings of the user. |
| https://www.googleapis.com/auth/gmail.metadata | This scope is required to view the email message metadata such as labels and headers, but not the email body. |