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

На этой странице описывается структура данных JSON файла манифеста Google 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

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

webapp

object ( Webapp )

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