Изменение OAuth scope не «выдаёт» скрипту новое право. Оно меняет набор разрешений, который код запрашивает у конкретного пользователя. Ручной запуск в редакторе может показать consent screen, а installable trigger работает без интерфейса и завершится `Authorization required`, пока его владелец не подтвердит новый scope.
Не начинайте с удаления всех подключений Google Account. Сначала откройте Project Overview, сохраните фактический список scopes и сравните его с `appsscript.json`. Если manifest содержит явный `oauthScopes`, Apps Script не добавит забытый scope автоматически.
Четыре слоя дают похожую ошибку доступа
| Слой | Вопрос | Проверка |
|---|---|---|
| code scan/manifest | scope вообще запрошен? | Project OAuth Scopes + appsscript.json |
| user consent | этот пользователь его выдал? | getAuthorizationInfo/ручной запуск |
| execution identity | от чьего имени работает код? | trigger owner/web app deployment |
| API/config | сервис включён и разрешён политикой? | Advanced service/Cloud project/admin policy |
| verification | scope sensitive/restricted? | OAuth consent screen status |
Явный manifest должен быть минимальным и полным
{
"timeZone": "Europe/Moscow",
"exceptionLogging": "STACKDRIVER",
"runtimeVersion": "V8",
"oauthScopes": [
"https://www.googleapis.com/auth/spreadsheets.readonly",
"https://www.googleapis.com/auth/script.external_request"
]
}Пример условный: добавляйте только scopes, соответствующие вызовам проекта. Google рекомендует для опубликованных scripts и add-ons явно задавать самый узкий набор. Если код начал вызывать GmailApp, а manifest остался read-only Sheets, consent не расширится сам; если добавить широкий Gmail scope без необходимости, растут требования к доверию и verification.
Authorization проверяется до фоновой работы
function checkAuthorization() {
const required = [
'https://www.googleapis.com/auth/spreadsheets.readonly'
];
const info = ScriptApp.getAuthorizationInfo(
ScriptApp.AuthMode.FULL, required
);
console.log(info.getAuthorizationStatus());
console.log(info.getAuthorizationUrl() || 'already authorized');
}Не отправляйте authorization URL в общий лог или чужой чат. Подготовительную функцию запускает тот пользователь, от имени которого будет выполняться trigger. Google также поддерживает granular consent: человек может выдать часть scopes, поэтому функции должны обрабатывать отсутствие необязательного разрешения, а обязательный набор проверять до операции.
Trigger наследует владельца, а не активного редактора
Installable trigger выполняется под учётной записью создателя. Другой редактор проекта не может авторизовать его за владельца. После изменения scopes каждый владелец trigger должен вручную пройти согласие либо trigger пересоздаётся по управляемой процедуре. Простые triggers имеют ещё более ограниченный authorization mode и не подходят для произвольного доступа к сервисам.
- Запишите creator email только в защищённый инвентарь, не в публичный лог.
- Сопоставьте trigger ID, handler и владельца до миграции.
- Сначала авторизуйте код вручную, затем возобновляйте расписание.
- Не создавайте дубликаты triggers при каждом открытии таблицы.
- Проверьте Executions: ошибка scope отличается от quota и admin policy.
Web app может работать как owner или как visitor
| Surface | Identity | Где появляется consent |
|---|---|---|
| editor run | user at keyboard | в редакторе |
| installable trigger | trigger creator | заранее ручным запуском |
| web app execute as me | deployment owner | владелец/публикация |
| web app execute as user | visiting user | у каждого пользователя |
| published add-on | current user + verified client | installation/feature use |
После изменения кода web app может продолжать обслуживать старую deployment version. Создайте новую версию и обновите deployment только после теста scopes. Если добавился sensitive или restricted scope для внешних пользователей, проверьте требования OAuth verification до выката.
Откат scopes не должен ломать уже выданные функции
Сужение manifest безопасно только после удаления вызовов, которым нужен старый scope. Сначала тестируйте функцию под пользователем с минимальным согласованным набором; затем обновляйте deployment. Не используйте широкий scope как быстрый ремонт неизвестного `Access denied` — точный API error и execution identity дадут причину быстрее.
План выката проверяет каждого исполнителя
- Сохранить diff appsscript.json и Project OAuth Scopes.
- Вручную запустить checkAuthorization под владельцем проекта.
- Повторить под владельцем каждого installable trigger.
- Проверить granular denial одного необязательного scope.
- Выпустить новую test deployment web app и проверить обе identity-модели.
- Просмотреть Executions без персональных данных и OAuth URL.
- Только после успешного теста обновить production deployment и расписания.
Для разбора подготовьте manifest, Project OAuth Scopes, тип surface, deployment setting, trigger owner role и точный error из Executions. Не передавайте access tokens, authorization URL или содержимое пользовательских файлов. Исправление доказано, когда ручной запуск, trigger и web app проходят под ожидаемыми identity с минимальным набором scopes.