Изменение OAuth scope не «выдаёт» скрипту новое право. Оно меняет набор разрешений, который код запрашивает у конкретного пользователя. Ручной запуск в редакторе может показать consent screen, а installable trigger работает без интерфейса и завершится `Authorization required`, пока его владелец не подтвердит новый scope.

Не начинайте с удаления всех подключений Google Account. Сначала откройте Project Overview, сохраните фактический список scopes и сравните его с `appsscript.json`. Если manifest содержит явный `oauthScopes`, Apps Script не добавит забытый scope автоматически.

Четыре слоя дают похожую ошибку доступа

СлойВопросПроверка
code scan/manifestscope вообще запрошен?Project OAuth Scopes + appsscript.json
user consentэтот пользователь его выдал?getAuthorizationInfo/ручной запуск
execution identityот чьего имени работает код?trigger owner/web app deployment
API/configсервис включён и разрешён политикой?Advanced service/Cloud project/admin policy
verificationscope 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

SurfaceIdentityГде появляется consent
editor runuser at keyboardв редакторе
installable triggertrigger creatorзаранее ручным запуском
web app execute as medeployment ownerвладелец/публикация
web app execute as uservisiting userу каждого пользователя
published add-oncurrent user + verified clientinstallation/feature use

После изменения кода web app может продолжать обслуживать старую deployment version. Создайте новую версию и обновите deployment только после теста scopes. Если добавился sensitive или restricted scope для внешних пользователей, проверьте требования OAuth verification до выката.

Откат scopes не должен ломать уже выданные функции

Сужение manifest безопасно только после удаления вызовов, которым нужен старый scope. Сначала тестируйте функцию под пользователем с минимальным согласованным набором; затем обновляйте deployment. Не используйте широкий scope как быстрый ремонт неизвестного `Access denied` — точный API error и execution identity дадут причину быстрее.

План выката проверяет каждого исполнителя

  1. Сохранить diff appsscript.json и Project OAuth Scopes.
  2. Вручную запустить checkAuthorization под владельцем проекта.
  3. Повторить под владельцем каждого installable trigger.
  4. Проверить granular denial одного необязательного scope.
  5. Выпустить новую test deployment web app и проверить обе identity-модели.
  6. Просмотреть Executions без персональных данных и OAuth URL.
  7. Только после успешного теста обновить production deployment и расписания.

Для разбора подготовьте manifest, Project OAuth Scopes, тип surface, deployment setting, trigger owner role и точный error из Executions. Не передавайте access tokens, authorization URL или содержимое пользовательских файлов. Исправление доказано, когда ручной запуск, trigger и web app проходят под ожидаемыми identity с минимальным набором scopes.

Проверенные источники