Struktur manifes

Halaman ini menjelaskan struktur data JSON file manifes Google Apps Script tingkat teratas. Manifes menentukan fungsi atau tujuan project Apps Script.

Representasi 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)
  }
}
Kolom
addOns

object (AddOns)

Konfigurasi resource project jika di-deploy sebagai add-on Google Workspace.

chat

object

Konfigurasi project jika di-deploy sebagai aplikasi Google Chat.

Untuk aplikasi Chat baru, gunakan kolom addOns.chat sebagai gantinya. Jika Anda mengelola aplikasi Chat yang sudah ada dan menggunakan kolom chat, kolom tersebut harus berupa objek kosong.

Untuk mengonfigurasi detail aplikasi Chat, Anda harus mengaktifkan Google Chat API. Untuk mengetahui detailnya, lihat Mengonfigurasi Google Chat API.

Apps Script menangani otorisasi di tingkat skrip. Aplikasi Chat yang memerlukan otorisasi tidak dapat melakukan tindakan hingga pengguna mengotorisasinya. Untuk memposting pesan sebelum otorisasi, tambahkan objek addToSpaceFallbackMessage ke manifes. Jika aplikasi Chat Anda memerlukan logika inisialisasi, Anda mungkin perlu menduplikasi logika ini dalam tindakan onMessage.

Contoh berikut menunjukkan aplikasi Chat yang merespons dengan pesan selamat datang default saat pengguna menambahkannya ke ruang Chat:

        "chat": {
          "addToSpaceFallbackMessage": "Thank you for adding me!"
        }
        
dependencies

object (Dependencies)

Konfigurasi layanan tingkat lanjut dan library yang diaktifkan untuk digunakan oleh project skrip.

exceptionLogging

string

Lokasi tempat pengecualian dicatat. Setelan yang valid meliputi:

  • NONE: Pengecualian tidak dicatat dalam log.
  • STACKDRIVER: Pengecualian dicatat di Stackdriver.
executionApi

object (ExecutionApi)

Konfigurasi yang dapat dieksekusi API project skrip. Ini hanya digunakan jika project di-deploy untuk eksekusi API.

oauthScopes[]

string

Definisi cakupan otorisasi yang digunakan oleh project skrip.

runtimeVersion

string

Versi runtime yang digunakan skrip. Jika dihilangkan, skrip akan menggunakan runtime default (STABLE). Opsi yang valid meliputi:

  • STABLE: Runtime default (saat ini Rhino).
  • V8: Runtime yang didukung V8.
  • DEPRECATED_ES5: Runtime Rhino. Nilai ini mencegah migrasi otomatis ke V8.
sheets

object (Sheets)

Konfigurasi resource yang menentukan Makro Spreadsheet.

timeZone

string

Zona waktu skrip dalam nilai ZoneId seperti "America/Denver".

urlFetchWhitelist[]

string

Daftar awalan URL HTTPS. Jika ada, setiap endpoint URL yang diambil harus cocok dengan awalan dalam daftar ini. Hal ini membantu melindungi data pengguna. Kolom ini bersifat opsional untuk deployment pengujian, tetapi wajib diisi untuk deployment. Pelajari lebih lanjut cara mengizinkan URL.

webapp

object (Webapp)

Konfigurasi aplikasi web project skrip, digunakan jika project di-deploy sebagai aplikasi web.