清单结构

此页面介绍了 Google Apps 脚本清单文件 JSON 数据结构的顶层。清单定义了 Apps 脚本项目的功能或用途。

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 应用，请改用 addOns.chat 字段。如果您维护使用 chat 字段的现有聊天应用，则该字段应为空对象。

如需配置聊天应用详细信息，您必须启用 Google Chat API。如需了解详情，请参阅配置 Google Chat API。

Apps 脚本在脚本级处理授权。 需要授权的聊天应用在获得用户授权之前无法执行操作。如需在授权之前发布消息，请向清单添加 addToSpaceFallbackMessage 对象。如果 Chat 应用需要初始化逻辑，您可能需要在 onMessage 操作中复制此逻辑。

以下示例展示了一个 Chat 应用，当用户将其添加到 Chat 聊天室时，该应用会回复一条默认的欢迎消息：

        "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)

定义 Google 表格宏的资源配置。

timeZone

string

脚本时区，采用 ZoneId 值（例如“America/Denver”）。
urlFetchWhitelist[]

string

HTTPS 网址前缀的列表。如果存在，提取的任何网址端点都必须与此列表中的一个前缀匹配。这有助于保护用户数据。对于测试部署，此字段是可选字段，但对于部署，此字段是必填字段。 详细了解如何将网址列入许可名单。

webapp

object (Webapp)

脚本项目 Web 应用配置，如果项目部署为 Web 应用，则使用此配置。