Glosarium

Istilah berikut digunakan di seluruh dokumentasi ini.

Add-on konferensi kalender

Jenis add-on khusus yang digunakan untuk memungkinkan penyedia konferensi mempresentasikan opsi konferensi di acara Google Kalender. Add-on ini memerlukan solusi konferensi yang dikembangkan dengan baik untuk dihubungkan oleh add-on. Karena persyaratan ini, sebagian besar developer tidak perlu membuat add-on konferensi Kalender.

Lihat add-on konferensi Kalender untuk mengetahui informasi selengkapnya. Lihat juga Mengupgrade add-on yang dipublikasikan untuk mengetahui informasi cara mengonversi add-on konferensi Kalender menjadi Add-on Google Workspace.

Kartu

Satu "halaman" dari UI add-on. Kartu terdiri dari objek widget yang berbeda (tombol, kolom teks, header, dan sebagainya).

Lihat Kartu untuk informasi selengkapnya.

Berbasis kartu

Add-on yang antarmuka penggunanya muncul sebagai panel di sidebar (atau, di perangkat seluler, saat jendela aktivitas lain dibuka melalui menu). Add-on ini memiliki toolbar atas yang mengidentifikasi add-on dan menampilkan kartu—pada dasarnya "halaman" UI add-on.

Add-on Google Workspace berbasis kartu.

Data konferensi

Serangkaian informasi yang diperlukan Google Kalender agar pengguna dapat membuat dan bergabung ke konferensi pihak ketiga yang diaktifkan oleh Add-on Google Workspace atau add-on konferensi Kalender.

Lihat Data konferensi untuk informasi selengkapnya.

Solusi konferensi

Representasi konferensi pihak ketiga yang dapat dibuat dari Google Kalender menggunakan Add-on Google Workspace atau add-on konferensi Kalender.

Lihat Solusi konferensi untuk mengetahui informasi selengkapnya.

Konteks

Status aplikasi host saat ini. Misalnya, pesan yang saat ini dibuka di Gmail, acara Kalender yang sedang Anda edit, atau file Drive yang telah Anda pilih yang merupakan bagian dari konteks aplikasi host saat ini. Konteks, bersama dengan informasi lainnya, dikumpulkan ke dalam objek peristiwa yang diteruskan ke fungsi pemicu sebagai parameter.

Pemicu kontekstual

Praktik menentukan pemicu yang diaktifkan saat pengguna memasukkan konteks tertentu, seperti saat mereka membuka rangkaian pesan email di Gmail. Pemicu kontekstual memungkinkan add-on Anda menyediakan UI yang relevan dengan konteks tersebut. Pemicu kontekstual dikonfigurasi dalam manifes project skrip add-on, sehingga merupakan jenis pemicu manifes.

Add-on Editor

Kumpulan jenis add-on asli yang hanya mengizinkan ekstensi Google Dokumen, Spreadsheet, Formulir, atau Slide. Add-on editor tidak berbasis kartu; tetapi, mengharuskan developer untuk membuat UI dari HTML dan CSS mentah. Setiap add-on editor hanya dapat memperluas satu aplikasi host.

Lihat Add-on Editor untuk mengetahui detail selengkapnya.

Objek peristiwa

Objek JSON yang otomatis dibuat saat halaman beranda diminta, saat add-on memasukkan konteks yang perlu direspons, atau sebagai hasil dari interaksi pengguna dengan widget di antarmuka add-on. Setelah dibuat, objek peristiwa diteruskan ke fungsi pemicu atau fungsi callback yang ditentukan. Tujuan objek peristiwa adalah meneruskan informasi dari lingkungan sisi klien pengguna (seperti informasi yang dimasukkan ke dalam widget antarmuka add-on) ke kode sisi server add-on, yang kemudian dapat menindaklanjuti informasi tersebut dan menampilkan respons yang sesuai.

Lihat Objek peristiwa untuk mengetahui detail selengkapnya.

Add-on Gmail

Add-on yang hanya memperluas Gmail. Add-on Gmail berbasis kartu. Sebagian besar detail fungsi, perilaku, dan pengembangan yang digunakan untuk membuat add-on Gmail identik dengan detail yang sama dengan yang digunakan untuk membuat Add-on Google Workspace.

Lihat Add-on Gmail untuk mengetahui informasi selengkapnya. Lihat juga Mengupgrade add-on yang dipublikasikan untuk mengetahui informasi cara mengonversi add-on Gmail menjadi Add-on Google Workspace.

Halaman Beranda

Kartu UI root add-on. Halaman beranda ditampilkan saat pengguna membuka add-on, dan memungkinkan add-on Anda menampilkan konten di luar konteks tertentu (misalnya, saat pengguna melihat rangkaian pesan email mereka di Gmail, tetapi belum membukanya). Anda menentukan tampilan dan perilaku halaman beranda add-on seperti kartu lainnya.

Lihat Halaman beranda untuk mengetahui informasi selengkapnya.

Aplikasi Host atau Host

Aplikasi Google Workspace diperluas Add-on Google Workspace, seperti Gmail atau Google Kalender.

Berbasis HTML

Add-on yang antarmuka penggunanya ditentukan menggunakan HTML dan CSS, bukan Layanan kartu bawaan Apps Script. Hanya Add-on Editor lama yang berbasis HTML.

Pemicu pratinjau link diaktifkan saat pengguna berinteraksi dengan URL pihak ketiga atau non-Google dalam aplikasi host Google, seperti Google Dokumen. Pemicu pratinjau link memungkinkan Anda menentukan pola URL untuk dipratinjau dari layanan atau API Anda, dan mengonfigurasi konten pratinjau, termasuk smart chip dan kartu pratinjau. Pemicu pratinjau link dikonfigurasi dalam manifes project skrip add-on sehingga merupakan jenis pemicu manifes.

Lihat Melihat pratinjau link di Google Dokumen untuk mengetahui informasi selengkapnya.

Manifes

File JSON yang dilampirkan ke project Apps Script. Manifes digunakan untuk menentukan informasi project yang diperlukan skrip agar berjalan dengan benar. Untuk Add-on Google Workspace, manifes digunakan untuk menentukan host yang dapat diperluas add-on dan menyediakan setelan kontrol UI tertentu.

Pemicu manifes

Pemicu yang ditentukan dalam manifes project, seperti pemicu halaman beranda atau pemicu kontekstual. Pemicu manifes digunakan secara eksklusif untuk membuat dan menampilkan kartu baru saat halaman beranda add-on diminta atau add-on memasuki konteks yang memerlukan update tampilan.

Pemicu manifes berbeda dengan pemicu lain di Apps Script karena pemicu tersebut tidak bawaan (seperti pemicu sederhana) dan tidak dapat dibuat secara terprogram dengan layanan Skrip Apps Script (seperti pemicu yang dapat diinstal).

Kartu non-kontekstual

Kartu yang menampilkan konten saat pengguna berada di luar konteks tertentu; misalnya, saat melihat rangkaian pesan email di Gmail, tetapi belum membuka rangkaian pesan. Halaman beranda adalah jenis kartu non-kontekstual.

Bagian di sebelah kanan UI host tempat UI Add-on Google Workspace muncul. Add-on Editor dan Gmail juga dapat menentukan sidebar.

Chip pintar

Smart chip adalah sebutan orang, file, acara kalender, atau entitas lain dalam aplikasi Google Workspace. Saat mengarahkan kursor ke chip, pengguna juga dapat melihat pratinjau konten tambahan terkait file atau link. Misalnya, saat pengguna mengarahkan kursor ke chip ke presentasi Google Slide, mereka akan melihat screenshot slide, pemilik presentasi, dan apakah mereka pernah melihat presentasi sebelumnya.

Anda dapat mengonfigurasi add-on untuk menggunakan smart chip guna melihat pratinjau link untuk layanan pihak ketiga atau non-Google. Lihat Melihat pratinjau link di Google Dokumen.

Pemicu

Kondisi dan respons peristiwa otomatis yang ditentukan oleh project atau add-on Apps Script. Pemicu diaktifkan saat peristiwa terkaitnya terjadi (misalnya, saat add-on dibuka) dan menyebabkan fungsi Apps Script tertentu (fungsi pemicu) dijalankan secara otomatis. Untuk Add-on Google Workspace, fungsi pemicu sering kali membuat Kartu baru untuk mengontrol bagian UI add-on yang ditampilkan. Hanya jenis peristiwa tertentu yang dapat memiliki pemicu.

Lihat pemicu add-on untuk mengetahui informasi selengkapnya.

Fungsi pemicu

Fungsi Apps Script dalam project yang dijalankan sebagai respons terhadap pemicu yang diaktifkan.

Widget

Elemen UI seperti tombol, kolom teks, atau kotak centang. Kartu dibuat dari urutan objek widget, yang ditentukan oleh Layanan Kartu bawaan Apps Script.

Lihat Widget untuk informasi selengkapnya.

Fungsi pengendali widget

Fungsi yang menautkan widget tertentu ke objek tindakan tertentu. Setiap jenis widget memiliki sekumpulan fungsi pengendali widget yang ditentukan yang dapat digunakan untuk terhubung ke tindakan. Fungsi hander widget menentukan jenis interaksi pengguna yang memicu tindakan yang dihasilkan, dan merupakan komponen penting dari interaktivitas widget.

Lihat Fungsi pengendali widget untuk mengetahui informasi selengkapnya.