Update (August 15, 2025): We updated this post to indicate that the rollout will start on August 26. Previously, the rollout was planned to start on August 19.
What’s changing
Earlier this year, we launched an improved version of the OAuth consent screen to the
Apps Script IDE and unpublished Editor Add-ons that allows users to specify which individual scopes they would like to authorize for that script. For example, if a script requests access to a user’s Sheets and Forms files, and the users only intends to use the script with Sheets files, they can decide to only allow access to their spreadsheets and not their forms.
This screenshot shows the new OAuth consent screen, which lets the user provide consent for a subset of the requested OAuth scopes.
We’re excited to announce that this more granular OAuth consent screen will be expanding to an additional Apps Script execution type. Soon, published
Editor add-ons powered by Apps Script will also present users with this more granular consent screen when requesting an OAuth grant. This will allow users of these add-on types to provide partial OAuth consent when authorizing new add-ons. A reminder that this also includes reconsenting to add-ons when
OAuth grants expire.
Additional details
To prepare for the release of this new consent flow, we suggest that Editor add-on developers refer to the
ScriptApp and
AuthorizationInfo classes. These allow Apps Script developers to programmatically interact with the scopes granted for a script. This allows developers to put in such safeguards as short-circuiting a script execution if not all scopes are granted. For more information,
refer to the developer documentation. To test these changes, please see the documentation on
Testing Editor Addons.
Getting Started
- Admins: There is no admin control for this feature.
- Developers and end users:
This new consent screen will only be used for new OAuth scope grants. Pre-existing scope grants will not be affected, so no action is required by users on scripts they’ve already authorized.
Rollout pace
Availability
- Available to all Google Workspace customers and Workspace Individual Subscribers