Структура манифеста

На этой странице описывается верхний уровень структуры данных JSON-файла манифеста проекта Apps Script. Манифест определяет функцию или назначение проекта Apps Script.

JSON-представление
{
  "addOns": {
    object (AddOns)
  },
  "chat": {},
  "dependencies": {
    object (Dependencies)
  },
  "exceptionLogging": string,
  "executionApi": {
    object (ExecutionApi)
  },
  "oauthScopes": [
    string
  ],
  "runtimeVersion": string,
  "sheets": {
    object (Sheets)
  },
  "timeZone": string,
  "urlFetchWhitelist": [
    string
  ],
  "webapp": {
    object (Webapp)
  }
}
Поля
addOns

object ( AddOns )

Конфигурация ресурсов проекта, если она развернута как надстройка Google Workspace .

chat

object

Конфигурация проекта при развертывании в виде приложения Google Chat .

Примечание: Для новых приложений чата мы рекомендуем использовать поле addOns.chat . Если вы поддерживаете существующее приложение чата, использующее это chat , оно должно быть пустым.

Для настройки приложения «Чат» необходимо включить API Google Chat. Подробнее см. в разделе «Настройка API Google Chat» .

Apps Script обрабатывает авторизацию на уровне скрипта. Чат-приложения, требующие авторизации, не могут выполнять никаких действий, пока пользователь не авторизует чат-приложение. Чтобы опубликовать сообщение до авторизации, можно добавить объект addToSpaceFallbackMessage в манифест. Если вашему чат-приложению требуется логика инициализации, возможно, потребуется продублировать эту логику в действии onMessage .

В следующем примере показано приложение чата, которое отвечает приветственным сообщением по умолчанию, когда пользователь добавляет его в пространство чата:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
        

dependencies

object ( Dependencies )

Конфигурация расширенных сервисов и библиотек, разрешенных для использования в проекте скрипта.

exceptionLogging

string

Место регистрации исключений. Допустимые настройки:

  • NONE означает, что исключения не регистрируются.
  • STACKDRIVER указывает, что исключения регистрируются в Stackdriver .
executionApi

object ( ExecutionApi )

Конфигурация исполняемого API проекта скрипта. Используется только в том случае, если проект развёрнут для выполнения API.

oauthScopes[]

string

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

runtimeVersion

string

Версия среды выполнения, используемая скриптом. Если это поле отсутствует в манифесте, скрипт использует среду выполнения по умолчанию ( STABLE ). Допустимые значения для этого поля:

  • STABLE указывает среду выполнения по умолчанию (в настоящее время Rhino).
  • V8 обозначает среду выполнения на базе V8.
  • DEPRECATED_ES5 указывает на среду выполнения Rhino. Установка этого значения также предотвращает автоматический переход на V8.
sheets

object ( Sheets )

Конфигурация ресурсов, определяющая макросы Таблиц .

timeZone

string

Часовой пояс скрипта в одном из доступных значений ZoneId , например «America/Denver».

urlFetchWhitelist[]

string

Список префиксов URL-адресов HTTPS. При наличии, любой полученный URL-адрес должен соответствовать одному из префиксов в этом списке. Это может помочь защитить данные пользователей. Это поле необязательно для тестовых развёртываний, но обязательно для развёртываний. Подробнее о добавлении URL-адресов в разрешённый список .

webapp

object ( Webapp )

Конфигурация веб-приложения проекта скрипта, которая используется только в том случае, если проект развернут как веб-приложение.