清单结构

本页介绍了 Apps Script 项目的清单文件 JSON 数据结构的顶级部分。

清单的子结构在单独的页面中定义:

清单

清单配置的顶级。

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 应用的详细信息,您必须启用 Google Chat API。如需了解详情,请参阅配置 Google Chat API

Apps Script 会在脚本级处理授权。 需要授权的 Chat 应用在用户授权之前无法执行任何操作。如需在授权之前发布消息,您可以向清单添加 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 应用的形式部署时才会使用。