Glosarium

Istilah berikut digunakan di seluruh dokumentasi ini.

Add-on konferensi Kalender

Jenis add-on khusus yang digunakan untuk mengizinkan penyedia konferensi menampilkan opsi konferensi dalam 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 diakses melalui menu). Add-on memiliki toolbar atas 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 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 mengetahui informasi selengkapnya.

Konteks

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

Pemicuan kontekstual

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

Add-on editor

Jenis add-on asli yang hanya mengizinkan ekstensi Google Dokumen, Spreadsheet, Formulir, atau Slide. Add-on editor tidak berbasis kartu; melainkan, add-on tersebut mengharuskan developer 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 dibuat secara otomatis saat halaman beranda diminta, saat add-on memasuki konteks yang perlu diresponnya, 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 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 fungsionalitas, 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.

Pemicu pratinjau link diaktifkan saat pengguna berinteraksi dengan URL pihak ketiga atau non-Google dalam aplikasi host Google, seperti Google Dokumen. Pemicuan pratinjau link memungkinkan Anda menentukan pola URL untuk melihat pratinjau dari layanan atau API Anda, dan mengonfigurasi konten pratinjau, termasuk chip smart dan kartu pratinjau. Pemicu pratinjau link dikonfigurasi di 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 dapat berjalan dengan benar. Untuk add-on Google Workspace, file manifest digunakan untuk menentukan host yang dapat diperluas oleh add-on dan memberikan setelan kontrol UI tertentu.

Pemicu manifes

Pemicu yang ditentukan dalam manifes project, seperti pemicu 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 dari 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 pesan 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

Chip smart adalah sebutan untuk 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 chip 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 terkaitnya terjadi (misalnya, saat add-on dibuka) dan menyebabkan fungsi Apps Script yang ditentukan (fungsi pemicu) dieksekusi 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 serangkaian 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 handler widget untuk mengetahui informasi selengkapnya.