Membuat antarmuka Google Kalender

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 {i>function<i} (jika ada). Fungsi ini membuat dan menampilkan kartu halaman beranda ke Kalender untuk ditampilkan. Jika tidak calendar.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, fungsi eventAttachmentTrigger 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:

  1. 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.
  2. Tambahkan atribut addOns.common dan addOns.calendar ke manifes project skrip add-on, termasuk cakupan yang diperlukan.
  3. Jika Anda memberikan model halaman beranda, menerapkan calendar.homepageTrigger fungsi untuk membangun antarmuka ini. Anda juga dapat memilih untuk menggunakan common.homepageTrigger untuk beberapa host Google Workspace.
  4. Jika Anda menyediakan antarmuka acara Kalender, Anda harus menerapkan calendar.eventOpenTrigger fungsi untuk membangun antarmuka ini. Lihat Memperluas antarmuka acara Kalender untuk mengetahui detailnya.
  5. 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 akan 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 ekstensi; solusi tambahan muncul hanya sebagai opsi dalam menu {i>drop-down<i} UI acara Google Kalender.