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

На этой странице описан верхний уровень структуры данных 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 . Чтобы настроить детали приложения 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 , например «Америка/Денвер».

urlFetchWhitelist[]

string

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

webapp

object ( Webapp )

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

,

На этой странице описан верхний уровень структуры данных 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 . Чтобы настроить детали приложения 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 , например «Америка/Денвер».

urlFetchWhitelist[]

string

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

webapp

object ( Webapp )

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