資訊清單結構

本頁面說明 Google Apps Script 資訊清單檔案 JSON 資料結構的頂層。資訊清單會定義 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 應用程式，請改用 addOns.chat 欄位。如果您維護使用 chat 欄位的現有 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)

定義資源設定 試算表巨集。

timeZone

string

指令碼時區，以 ZoneId 值表示，例如「America/Denver」。
urlFetchWhitelist[]

string

HTTPS 網址前置字元清單。如果存在，擷取的任何網址端點都必須符合這份清單中的前置字元。這有助於保護使用者資料。這個欄位為測試部署作業的選填欄位，但部署作業則為必填欄位。進一步瞭解如何將網址加入許可清單。
webapp

object (Webapp)

指令碼專案網頁應用程式設定，用於將專案部署為網頁應用程式。