Add-on Google Workspace dapat memberikan antarmuka saat pengguna melihat atau mengedit kalender dan acara Kalender. Ini memungkinkan Anda memberikan informasi tambahan yang relevan kepada pengguna, tugas, dan menghubungkan sistem pihak ketiga ke Google Kalender.
Saat membuat antarmuka add-on untuk Google Kalender, Anda dapat memberikan halaman beranda Anda. Anda dapat menggunakan beranda untuk beberapa {i>host<i}, atau mendesain beranda khusus untuk Google Kalender.
Add-on Anda juga dapat menentukan antarmuka yang muncul saat pengguna acara Kalender terbuka.
Mengakses UI add-on
Bergantung pada cara aplikasinya 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 dijalankan
calendar.homepageTrigger
yang sesuai (jika ada). Fungsi ini membuat dan menampilkan kartu halaman beranda ke Kalender untuk ditampilkan. Jika tidakcalendar.homepageTrigger
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
menjalankan fungsi
eventOpenTrigger
{i>function<i} (jika ada). Fungsi ini membangun 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 membuat lampiran add-on dan mengembalikannya ke Google Kalender untuk ditampilkan.
Membuat antarmuka add-on Kalender
Anda dapat memperluas Google Kalender dengan Add-on Google Workspace dengan mengikuti langkah-langkah berikut:
- Tentukan apakah Anda ingin add-on memiliki fitur khusus Kalender halaman beranda Anda. Tentukan juga apakah Anda ingin menyediakan antarmuka khusus saat pengguna mengedit acara Kalender.
- Tambahkan atribut
addOns.common
danaddOns.calendar
ke manifes project skrip add-on, termasuk cakupan yang diperlukan. - Jika Anda memberikan model
halaman beranda,
menerapkan
calendar.homepageTrigger
fungsi untuk membangun antarmuka ini. Anda juga dapat memilih untuk menggunakancommon.homepageTrigger
untuk beberapa host Google Workspace. - Jika Anda menyediakan antarmuka acara Kalender, Anda harus menerapkan
calendar.eventOpenTrigger
fungsi untuk membangun antarmuka ini. Lihat Memperluas antarmuka acara Kalender untuk mengetahui detailnya. - Implementasikan fungsi callback terkait yang diperlukan untuk merespons permintaan pengguna Interaksi UI, 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
adalah addOns.calendar
di 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 di
project skrip add-on Anda. Fungsi ini otomatis dipanggil untuk membuat
Halaman beranda Google Kalender saat diperlukan. Anda harus mengimplementasikan fungsi ini untuk membangun
dan mengembalikan satu
Card
atau array
Card
berbagai objek yang membentuk beranda. Fungsi pemicu halaman beranda diberi
objek peristiwa
parameter yang berisi beberapa informasi umum seperti
terkelola sepenuhnya. Anda dapat menggunakan data objek peristiwa untuk menyesuaikan konstruksi
{i>homepage<i}.
Memperluas antarmuka acara Kalender
Google Kalender bergantung pada pemicu kontekstual untuk menentukan antarmuka yang
(jika ada) untuk ditampilkan saat pengguna mengedit acara Kalender. Kapan pemicu
diaktifkan, fungsi ini menjalankan fungsi pemicu kontekstual yang ditentukan oleh
calendar.eventOpenTrigger
di manifes add-on.
Anda harus mengimplementasikan fungsi yang dinamai dalam
calendar.eventOpenTrigger
kolom tersebut. Fungsi ini menerima objek peristiwa sebagai
dan harus mengembalikan salah satu
Objek Card
atau array
Objek Card
agar Kalender dapat
ditampilkan selama pengguna membuka acara.
Objek peristiwa
Objek peristiwa dibuat dan
diteruskan ke
calendar.eventOpenTrigger
fungsi pemicu kontekstual saat pengguna membuka
acara Kalender. Fungsi pemicu dapat menggunakan informasi dalam peristiwa ini
untuk menentukan cara membuat kartu add-on atau mengontrol add-on
perilaku model. Objek peristiwa juga dibuat dan diteruskan ke
homepageTrigger
berfungsi saat add-on pertama kali dibuka, dan saat pengguna mengklik atau memilih
widget interaktif.
Struktur lengkap objek peristiwa dijelaskan dalam Objek peristiwa. Bila Kalender adalah aplikasi host yang bertindak atas add-on, pemicu kontekstual dan objek peristiwa interaksi widget menyertakan Objek acara Kalender yang membawa informasi klien khusus Kalender.
Memperbarui acara Kalender
Selain konteks
calendar.eventOpenTrigger
yang aktif saat pengguna membuka
acara Kalender untuk diedit, Anda juga dapat menetapkan
calendar.eventUpdateTrigger
yang aktif saat pengguna memperbarui dan menyimpan acara Kalender. Hanya pemicu ini
akan 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 menjalankan
fungsi pemicu yang ditentukan oleh
calendar.eventUpdateTrigger
manifes. Fungsi ini dieksekusi sebelum pengeditan acara Kalender
disimpan.
calendar.eventUpdateTrigger
biasanya digunakan untuk melakukan satu atau beberapa hal berikut:
- Memperbarui antarmuka acara Kalender add-on sebagai respons terhadap perubahan pengguna ke acara Kalender.
- Menyinkronkan data acara Kalender dengan sistem pihak ketiga, seperti konferensi yang terhubung ke Google Kalender.
Jika Anda memerlukan add-on untuk melakukan penyesuaian pada data acara Kalender (seperti
sebagai daftar pesertanya), Anda harus menetapkan add-on
calendar.currentEventAccess
kolom manifes ke WRITE
atau READ_WRITE
. Hal ini juga
mengharuskan add-on memiliki
https://www.googleapis.com/auth/calendar.addons.current.event.write
cakupan Anda.
Menambahkan solusi konferensi
Solusi konferensi mewakili opsi konferensi pihak ketiga yang dapat dilampirkan oleh pengguna Acara Google Kalender. Tujuan Ringkasan konferensi pihak ketiga memberikan detail tentang cara membangun {i>add-on<i} yang menambahkan solusi konferensi. Tidak perlu membangun UI untuk jenis extension; solusi tambahan muncul hanya sebagai opsi dalam menu {i>drop-down<i} UI acara Google Kalender.