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 di acara Google Kalender. Add-on ini memerlukan solusi konferensi yang dikembangkan dengan baik agar add-on dapat terhubung. Karena persyaratan ini, sebagian besar developer tidak pernah 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 tentang cara mengonversi add-on konferensi Kalender menjadi add-on Google Workspace.

Kartu

Satu "halaman" UI add-on. Kartu terdiri dari berbagai objek widget (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 atas yang mengidentifikasi add-on dan menampilkan kartu—pada dasarnya adalah "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 mengetahui 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 mana yang saat ini terbuka di Gmail, acara Kalender mana yang Anda edit, atau file Drive mana yang telah Anda pilih adalah 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 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; tetapi, add-on ini memerlukan 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 otomatis dibuat saat halaman beranda diminta, saat add-on memasuki 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 untuk meneruskan informasi dari lingkungan sisi klien pengguna (seperti informasi yang telah mereka masukkan 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 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 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 email di Gmail, tetapi belum membukanya). Anda menentukan tampilan dan perilaku halaman beranda add-on seperti kartu lainnya.

Lihat Halaman beranda untuk mengetahui informasi selengkapnya.

Host atau Aplikasi host

Aplikasi Google Workspace yang diperluas oleh 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.

Pratinjau link dipicu 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 pratinjau dari layanan atau API, dan mengonfigurasi konten pratinjau, termasuk chip pintar 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 diperlukan skrip agar berjalan dengan benar. Untuk add-on Google Workspace, manifes digunakan untuk menentukan host 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 pembaruan tampilan.

Pemicu manifes berbeda dengan pemicu lain di Apps Script karena 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 email di Gmail, tetapi belum membukanya. 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.

Smart chip

Smart chip adalah sebutan untuk orang, file, acara kalender, atau entitas lainnya 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 chip 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 chip smart 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 terkait terjadi (misalnya, saat add-on dibuka) dan menyebabkan fungsi Apps Script yang ditentukan (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 mengetahui informasi selengkapnya.

Fungsi pengendali widget

Fungsi yang menautkan widget tertentu ke objek tindakan tertentu. Setiap jenis widget memiliki kumpulan fungsi pengendali widget yang ditentukan yang dapat digunakan untuk terhubung ke tindakan. Fungsi pengendali 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.