資訊清單結構

本頁說明 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)

定義 Sheets 巨集的資源設定。

timeZone

string

任一可用的 ZoneId 值中的 script 時區,例如「America/Denver」。

urlFetchWhitelist[]

string

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

webapp

object (Webapp)

指令碼專案的網頁應用程式設定,只有在專案以網頁應用程式形式部署時才會使用。