Включение авторизации и доступа к скриптам

API Apps Script требует разных типов авторизации в зависимости от вашей цели:

  • Используйте Apps Script API в своем приложении.
  • Разрешите другим приложениям управлять данными или развертываниями вашего проекта скрипта.

Если вам нужно использовать Apps Script API в своем приложении, вам необходимо включить API в проекте Google Cloud приложения. Это позволяет вам создавать учетные данные OAuth, чтобы пользователи приложения могли его авторизовать.

Если вы хотите, чтобы сторонние приложения управляли содержимым или развертыванием ваших проектов сценариев, вам необходимо предоставить доступ к вашим проектам сценариев.

Использование Apps Script API в вашем приложении

Если вы хотите использовать Apps Script API внутри своего приложения, вам необходимо включить Apps Script API в проекте GCP вашего приложения. После включения Apps Script API вы можете создать учетные данные OAuth и загрузить идентификатор и секрет клиента для включения в свое приложение. Вы также можете отслеживать использование API в консоли Google Cloud .

Вы можете использовать этот мастер , чтобы создать или выбрать проект Google Cloud в консоли API и автоматически включить API. Кроме того, вы можете открыть страницу «Управление ресурсами» консоли , выбрать проект, затем выполнить поиск и добавить Apps Script API вручную, используя панель управления API и службами проекта. После включения API вы можете создавать учетные данные OAuth, идентификаторы клиентов и секреты клиентов для своих приложений на панели API и сервисы > Учетные данные .

В кратких руководствах по Apps Script API представлен пошаговый обзор всего процесса включения API и настройки авторизации для приложения.

Предоставление сторонним приложениям доступа к вашим проектам сценариев

API Apps Script позволяет приложениям создавать и изменять сценарии и их развертывания . Это может привести к плохой ситуации, если вы авторизуете вредоносное стороннее приложение, которое затем начнет создавать новые вредоносные сценарии или изменять поведение уже имеющихся у вас сценариев.

Чтобы снизить этот риск, API Apps Script по умолчанию не имеет доступа к вашим проектам сценариев. Вы должны явно предоставить доступ к API, прежде чем сможете использовать любое приложение, которое создает или изменяет сценарии или развертывания. После того как вы предоставите доступ API к своим сценариям, авторизованные вами приложения смогут использовать API для управления вашими проектами сценариев.

Ошибка возникает, если вы попытаетесь запустить уязвимое приложение без предварительного предоставления доступа к API. Эта ошибка возникает после авторизации приложения.

Вы можете предоставить API Apps Script доступ к своим проектам скриптов с помощью панели управления Apps Script . Вы также можете использовать панель управления, чтобы в любое время отозвать этот доступ. Предоставляя доступ к API, вы делаете это для всех приложений. Однако отдельные приложения по-прежнему требуют авторизации.

Прежде чем предоставить доступ, убедитесь, что вы понимаете, что разрешение приложениям изменять ваши сценарии сопряжено с риском. Никогда не разрешайте любое приложение, которое, по вашему мнению, является вредоносным.