Layanan Kalender lanjutan memungkinkan Anda menggunakan Google Calendar API publik di Apps Script. Mirip dengan layanan Kalender bawaan Apps Script, API ini memungkinkan skrip mengakses dan mengubah Google Kalender pengguna, termasuk kalender tambahan langganan pengguna. Pada umumnya, layanan bawaan lebih mudah digunakan, tetapi layanan lanjutan ini menyediakan beberapa fitur tambahan, termasuk menyetel warna latar belakang untuk setiap peristiwa.
Referensi
Untuk informasi mendetail tentang layanan ini, lihat dokumentasi referensi untuk Google Calendar API publik. Seperti semua layanan lanjutan di Apps Script, layanan Kalender lanjutan menggunakan objek, metode, dan parameter yang sama dengan API publik. Untuk informasi selengkapnya, lihat Cara tanda tangan metode ditentukan.
Untuk melaporkan masalah dan menemukan dukungan lainnya, lihat Panduan dukungan Kalender.
Header permintaan HTTP
Layanan Kalender lanjutan dapat menerima header permintaan HTTP If-Match
dan If-None-Match
. Untuk mengetahui detailnya, lihat dokumentasi referensi.
Kode contoh
Kode contoh di bawah menggunakan API versi 3.
Membuat peristiwa
Contoh berikut menunjukkan cara membuat acara di kalender default pengguna.
Kalender listingan
Contoh berikut menunjukkan cara mengambil detail tentang kalender yang ditampilkan dalam daftar kalender pengguna.
Peristiwa listingan
Contoh berikut menunjukkan cara mencantumkan 10 acara mendatang berikutnya di kalender default pengguna.
Mengubah peristiwa secara bersyarat
Contoh berikut menunjukkan cara memperbarui acara Kalender secara bersyarat menggunakan
header If-Match
. Skrip akan membuat peristiwa baru, menunggu 30 detik, lalu
memperbarui peristiwa hanya jika tidak ada detail peristiwa yang berubah sejak peristiwa
dibuat.
Mengambil peristiwa secara bersyarat
Contoh berikut menunjukkan cara mengambil peristiwa Kalender secara bersyarat menggunakan
header If-None-Match
. Skrip akan membuat peristiwa baru, lalu melakukan polling
pada peristiwa tersebut untuk perubahan selama 30 detik. Setiap kali peristiwa berubah, versi baru akan diambil.
Menyinkronkan acara
Contoh berikut menunjukkan cara mengambil peristiwa menggunakan token sinkronisasi. Jika Anda menyertakan token sinkronisasi dalam permintaan layanan lanjutan Kalender, respons yang dihasilkan hanya akan menyertakan item yang telah berubah sejak token tersebut dibuat, sehingga memungkinkan pemrosesan yang lebih efisien. Lihat Menyinkronkan Resource secara Efisien untuk detail selengkapnya tentang proses sinkronisasi.
Contoh berikut menggunakan metode getRelativeDate(daysOffset, hour)
yang sama seperti yang ditentukan dalam contoh di atas.