Resource manifes Gmail

Konfigurasi resource yang digunakan untuk menentukan konten dan perilaku add-on Google Workspace dalam Gmail. Manifes add-on Google Workspace harus memiliki semua komponen yang ditandai sebagai Wajib jika memperluas Gmail.

Gmail

Konfigurasi manifes add-on Google Workspace untuk ekstensi Gmail. Lihat Memperluas Gmail dengan add-on Google Workspace untuk mengetahui informasi selengkapnya.

Representasi JSON
{
  "authorizationCheckFunction": string,
  "composeTrigger": {
    object (ComposeTrigger)
  },
  "contextualTriggers": [
    {
      object (ContextualTrigger)
    }
  ],
  "homepageTrigger": {
    object (HomepageTrigger)
  }
}
Kolom
authorizationCheckFunction

string

Tidak digunakan lagi. Nama fungsi Apps Script yang melakukan pemeriksaan persyaratan otorisasi pihak ketiga. Fungsi ini dipanggil sebelum setiap pemanggilan add-on Google Workspace.

Fungsi ini tidak digunakan lagi untuk menghindari latensi eksekusi yang tidak perlu. Sebagai gantinya, add-on harus menampilkan pengecualian dari pemanggilan utama, seperti yang ditunjukkan dalam contoh ini.

composeTrigger

object (ComposeTrigger)

Wajib untuk tindakan compose. Menentukan kumpulan UI yang tersedia bagi pengguna saat menulis email.

Lihat Memperluas UI compose dengan tindakan compose untuk mengetahui detailnya.

contextualTriggers[]

object (ContextualTrigger)

Wajib. Daftar pemicu yang diaktifkan saat pesan dibuka di Gmail. Saat diaktifkan, pemicu akan mengeksekusi fungsi Apps Script tertentu, biasanya untuk membuat kartu baru dan memperbarui UI.
homepageTrigger

object (HomepageTrigger)

Spesifikasi fungsi pemicu untuk membuat halaman beranda add-on di host Gmail. Tindakan ini akan menggantikan addOns.common.homepageTrigger.

ComposeTrigger

Konfigurasi untuk tindakan compose. Lihat Memperluas UI Compose untuk mengetahui informasi selengkapnya.

Representasi JSON
{
  "draftAccess": string,
  "selectActions": [
    {
      object (SelectAction)
    }
  ]
}
Kolom
draftAccess

string

Menentukan tingkat akses data yang tersedia untuk fungsi pemicu compose. Opsi yang valid adalah sebagai berikut:

  • NONE, setelan default. Hal ini menyebabkan objek peristiwa yang diteruskan ke fungsi pemicu compose sebagian besar kosong.
  • METADATA, yang mengisi objek peristiwa yang diteruskan ke fungsi pemicu compose dengan daftar penerima pesan. Setelan ini mengharuskan add-on menyertakan cakupan gmail.addons.current.message.metadata.
selectActions[]

object (SelectAction)

Daftar tindakan compose yang membuat UI compose; namun, daftar ini dibatasi untuk satu tindakan per add-on. Tindakan tulis memiliki ikon yang sesuai yang ditampilkan di jendela tulis Gmail. Ikon ditentukan oleh gmail.logoUrl.

ContextualTrigger

Konfigurasi untuk pemicu yang diaktifkan saat pengguna membuka pesan Gmail dan pesan tersebut memenuhi kriteria tertentu. Lihat Memperluas UI pesan untuk mengetahui informasi selengkapnya.

Representasi JSON
{
  "onTriggerFunction": string,
  "unconditional": {},
}
Kolom
onTriggerFunction

string

Wajib untuk setiap pemicu kontekstual. Nama fungsi Apps Script yang dijalankan saat pemicu diaktifkan.

Lihat Fungsi pemicu kontekstual untuk mengetahui detail tentang cara menentukan fungsi ini.

unconditional

object

Wajib untuk setiap pemicu kontekstual. Digunakan untuk menentukan bahwa pemicu kontekstual diaktifkan untuk semua pesan Gmail saat dibuka. Saat ini, ini adalah satu-satunya opsi, sehingga harus selalu berupa objek kosong.

SelectAction

Konfigurasi tindakan compose yang menentukan fungsi yang akan dijalankan saat pengguna memilih tindakan compose.

Representasi JSON
{
  "runFunction": string,
  "text": string
}
Kolom
runFunction

string

Wajib untuk tindakan compose. Nama fungsi Apps Script yang dijalankan saat tindakan compose ini dipilih. Fungsi pemicu compose ini mem-build UI compose add-on.

Lihat Fungsi pemicu Compose untuk mengetahui detailnya.

text

string

Wajib untuk tindakan compose. Deskripsi teks singkat tentang tindakan compose ini.