マニフェストの構造

このページでは、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

Chat アプリの詳細を構成するには、 Google Chat API を有効にする必要があります。詳しくは、 Google Chat API を構成するをご覧ください。

Apps Script は、スクリプト レベルで承認を処理します。 承認が必要な Chat アプリは、 ユーザーが承認するまでアクションを実行できません。承認前にメッセージを投稿するには、addToSpaceFallbackMessage オブジェクトをマニフェストに追加します。Chat アプリに初期化ロジックが必要な場合は、このロジックを onMessage アクションで複製する必要があるかもしれません。

次の例は、ユーザーが Chat スペースに 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 ランタイム。この値を指定すると、 自動移行が防止されます。
sheets

object (Sheets)

Sheets マクロを定義するリソース構成。
timeZone

string

「America/Denver」などの ZoneId 値の スクリプトのタイムゾーン。
urlFetchWhitelist[]

string

HTTPS URL 接頭辞のリスト。存在する場合、取得された URL エンドポイントは、このリストの接頭辞と一致する必要があります。このプロパティは、ユーザーデータの保護に役立ちます。この フィールドは、テスト デプロイでは省略可能ですが、デプロイでは必須です。 詳しくは、 URL を許可リストに登録するをご覧ください。

webapp

object (Webapp)

プロジェクトがウェブアプリとしてデプロイされている場合に使用される、スクリプト プロジェクトのウェブアプリ構成。