Add-on Google Workspace dapat menyediakan antarmuka yang disesuaikan saat pengguna melihat atau mengedit kalender dan acara Kalender. Hal ini memungkinkan Anda memberikan informasi tambahan yang relevan kepada pengguna, mengotomatiskan tugas, dan menghubungkan sistem pihak ketiga ke Google Kalender.
Saat membuat antarmuka add-on untuk Google Kalender, Anda dapat menyediakan halaman beranda. Anda dapat menggunakan beranda yang sama untuk beberapa host, atau mendesain beranda tertentu untuk Google Kalender.
Add-on juga dapat menentukan antarmuka yang muncul saat pengguna membuka acara Kalender.
Mengakses UI add-on
Bergantung pada cara file dibuka, Add-on Google Workspace dapat menentukan antarmuka halaman beranda, antarmuka acara Google Kalender, antarmuka pemilihan lampiran, atau ketiganya:
- Jika pengguna mengklik ikon add-on saat berada dalam tampilan kalender, add-on akan mengeksekusi
fungsi
calendar.homepageTrigger
yang sesuai (jika ada). Fungsi ini membuat dan menampilkan kartu halaman beranda ke Kalender untuk ditampilkan. Jika tidak ada fungsicalendar.homepageTrigger
yang ditentukan, kartu halaman beranda generik akan ditampilkan. - Jika pengguna membuka acara Kalender lalu mengklik ikon add-on, atau
add-on terbuka saat pengguna membuka acara, add-on
akan menjalankan fungsi
eventOpenTrigger
yang sesuai (jika ada). Fungsi ini mem-build antarmuka acara Kalender add-on dan kembali ke Google Kalender untuk ditampilkan. - Jika add-on menentukan fungsi
eventAttachmentTrigger
, add-on akan muncul sebagai penyedia lampiran saat pengguna mengklik Tambahkan lampiran saat mengedit acara Kalender. Saat add-on dipilih, fungsieventAttachmentTrigger
akan mem-build antarmuka pemilihan lampiran add-on dan menampilkannya ke Google Kalender untuk ditampilkan.
Membuat antarmuka Kalender add-on
Anda dapat menyediakan Google Kalender dengan Add-on Google Workspace dengan mengikuti langkah-langkah berikut:
- Tentukan apakah Anda ingin add-on memiliki halaman beranda khusus Kalender. Selain itu, tentukan apakah Anda ingin menyediakan antarmuka kustom saat pengguna mengedit acara Kalender.
- Tambahkan kolom
addOns.common
danaddOns.calendar
yang sesuai ke manifes project skrip add-on, termasuk semua cakupan yang diperlukan. - Jika Anda menyediakan
halaman beranda
khusus Kalender,
terapkan fungsi
calendar.homepageTrigger
untuk mem-build antarmuka ini. Anda juga dapat memilih untuk menggunakan antarmukacommon.homepageTrigger
untuk beberapa host Google Workspace. - Jika menyediakan antarmuka acara Kalender, Anda harus menerapkan fungsi
calendar.eventOpenTrigger
untuk membuat antarmuka ini. Lihat Memperluas antarmuka acara Kalender untuk mengetahui detailnya. - Implementasikan fungsi callback terkait yang diperlukan untuk merespons interaksi UI pengguna, seperti klik tombol.
Halaman beranda kalender
Google Kalender mendukung tampilan halaman beranda Add-on Google Workspace.
Untuk menampilkan halaman beranda umum add-on di Google Kalender, cukup pastikan
kolom addOns.calendar
ada dalam manifes add-on.
Atau, tambahkan
calendar.homepageTrigger
ke manifes add-on untuk menyediakan halaman beranda khusus Kalender.
Dalam kedua kasus tersebut, Anda harus memberikan nama fungsi pemicu halaman beranda dalam
project skrip add-on Anda. Fungsi ini dipanggil secara otomatis untuk membuat halaman beranda Google Kalender saat diperlukan. Anda harus menerapkan fungsi ini untuk mem-build dan menampilkan satu Card
atau array objek Card
yang membentuk halaman beranda. Fungsi pemicu halaman beranda diberi objek peristiwa sebagai parameter yang berisi beberapa informasi umum, seperti platform klien. Anda dapat menggunakan data objek peristiwa untuk menyesuaikan konstruksi
halaman beranda.
Memperluas antarmuka acara Kalender
Google Kalender mengandalkan pemicu kontekstual untuk menentukan antarmuka apa
(jika ada) yang akan ditampilkan saat pengguna mengedit acara Kalender. Saat diaktifkan, pemicu akan menjalankan fungsi pemicu kontekstual yang ditentukan oleh kolom
calendar.eventOpenTrigger
dalam manifes add-on.
Anda harus menerapkan fungsi yang dinamai di kolom calendar.eventOpenTrigger
. Fungsi ini menerima objek peristiwa sebagai argumen dan harus menampilkan satu objek Card
atau array objek Card
agar Kalender dapat ditampilkan saat pengguna membuka peristiwa.
Objek peristiwa
Objek peristiwa dibuat dan diteruskan ke fungsi pemicu kontekstual calendar.eventOpenTrigger
saat pengguna membuka acara Kalender. Fungsi pemicu dapat menggunakan informasi dalam objek peristiwa ini
untuk menentukan cara membuat kartu add-on atau mengontrol perilaku
add-on. Objek peristiwa juga dibuat dan diteruskan ke
fungsi homepageTrigger
saat add-on pertama kali dibuka, dan saat pengguna mengklik atau memilih
widget interaktif.
Struktur lengkap objek peristiwa dijelaskan dalam Objek peristiwa. Jika Kalender adalah aplikasi host yang bertindak dari add-on, pemicu kontekstual dan objek peristiwa interaksi widget menyertakan kolom Objek acara Kalender yang membawa informasi klien khusus Kalender.
Memperbarui acara Kalender
Selain
calendar.eventOpenTrigger
kontekstual yang diaktifkan saat pengguna membuka
acara Kalender untuk diedit, Anda juga dapat menentukan
calendar.eventUpdateTrigger
yang diaktifkan saat pengguna mengupdate dan menyimpan acara Kalender. Pemicu ini hanya
aktif jika pengguna melakukan satu atau beberapa pengeditan berikut:
- Menambahkan satu atau beberapa tamu.
- Menghapus satu atau beberapa tamu.
- Menambahkan atau beralih ke solusi konferensi yang berbeda.
Saat diaktifkan, pemicu ini akan menjalankan
fungsi pemicu yang ditentukan oleh
kolom manifes
calendar.eventUpdateTrigger
. Fungsi ini dijalankan sebelum hasil edit acara Kalender disimpan.
calendar.eventUpdateTrigger
biasanya digunakan untuk melakukan satu atau beberapa hal berikut:
- Update antarmuka acara Kalender add-on sebagai respons terhadap perubahan pengguna pada acara Kalender.
- Menyinkronkan data acara Kalender dengan sistem pihak ketiga, seperti sistem konferensi yang terhubung ke Google Kalender.
Jika memerlukan add-on untuk melakukan penyesuaian pada data acara Kalender (seperti
daftar tamunya), Anda harus menetapkan kolom manifes
calendar.currentEventAccess
add-on ke WRITE
atau READ_WRITE
. Hal ini juga
mengharuskan add-on untuk memiliki
cakupan
https://www.googleapis.com/auth/calendar.addons.current.event.write
.
Menambahkan solusi konferensi
Solusi konferensi mewakili opsi konferensi pihak ketiga yang dapat ditambahkan pengguna ke acara Google Kalender. Dokumentasi Ringkasan konferensi pihak ketiga memberikan detail tentang cara mem-build add-on yang menambahkan solusi konferensi baru. Anda tidak perlu mem-build UI untuk jenis ekstensi ini; solusi tambahan hanya muncul sebagai opsi di menu drop-down UI acara Google Kalender.