Glosarium

Istilah berikut digunakan di seluruh dokumentasi ini.

Add-on konferensi Kalender

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

Lihat add-on konferensi Kalender untuk informasi selengkapnya. Lihat juga Mengupgrade add-on yang dipublikasikan untuk mengetahui informasi tentang 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 mengetahui informasi selengkapnya.

Berbasis kartu

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

Add-on Google Workspace berbasis kartu.

Data konferensi

Kumpulan 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 informasi selengkapnya.

Konteks

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

Pemicu kontekstual

Praktik menentukan pemicu yang diaktifkan saat pengguna memasuki konteks tertentu, seperti saat mereka membuka rangkaian 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. Namun, add-on ini 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 detail selengkapnya.

Objek peristiwa

Objek JSON yang dibuat secara otomatis saat halaman beranda diminta, saat add-on memasuki konteks yang perlu direspons, atau sebagai hasil interaksi pengguna dengan widget di antarmuka add-on. Setelah dibuat, objek peristiwa akan diteruskan ke fungsi pemicu atau fungsi callback yang ditentukan. Tujuan objek peristiwa adalah untuk meneruskan informasi dari lingkungan sisi klien pengguna (seperti informasi yang dimasukkan ke 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 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 informasi selengkapnya. Lihat juga Mengupgrade add-on yang dipublikasikan untuk mengetahui informasi tentang 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 emailnya di Gmail, tetapi belum membukanya). Anda menentukan tampilan dan perilaku halaman beranda add-on seperti kartu lainnya.

Lihat Halaman beranda untuk informasi selengkapnya.

Aplikasi Host atau Host

Aplikasi Google Workspace yang 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. Dengan pemicu pratinjau link, Anda dapat menentukan pola URL yang akan dipratinjau dari layanan atau API, 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 dengan smart chip untuk mengetahui informasi selengkapnya.

Manifes

File JSON yang dilampirkan ke project Apps Script. Manifes digunakan untuk menentukan informasi project yang perlu dijalankan skrip dengan benar. Untuk Add-on Google Workspace, manifes digunakan untuk menentukan host mana yang dapat diperluas oleh 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 tidak bawaan (seperti pemicu sederhana) dan tidak dapat dibuat secara terprogram dengan layanan Script 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 Gmail dan Editor 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 tentang file atau link. Misalnya, saat pengguna mengarahkan kursor ke presentasi Google Slide, mereka akan melihat screenshot slide, pemilik presentasi, dan apakah mereka pernah melihat presentasi tersebut sebelumnya.

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

Pemicu

Kondisi dan respons peristiwa otomatis yang ditentukan oleh project atau add-on Apps Script. Pemicu diaktifkan saat peristiwa terkait 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 dieksekusi 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 mengetahui informasi selengkapnya.

Fungsi pengendali widget

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

Lihat Fungsi pengendali widget untuk mengetahui informasi selengkapnya.