Layanan Kalender lanjutan memungkinkan Anda menggunakan API Google Kalender publik di Apps Script. Mirip dengan layanan Kalender bawaan Apps Script, API ini memungkinkan skrip untuk mengakses dan mengubah Google Kalender pengguna, termasuk kalender tambahan yang menjadi langganan pengguna. 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 seperti 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 ini menggunakan API versi 3.
Membuat peristiwa
Contoh berikut menunjukkan cara membuat acara di kalender default pengguna.
Mencantumkan kalender
Contoh berikut menunjukkan cara mengambil detail tentang kalender yang ditampilkan dalam daftar kalender pengguna.
Mencantumkan acara
Contoh berikut menunjukkan cara mencantumkan 10 acara mendatang berikutnya dalam kalender default pengguna.
Mengubah peristiwa secara bersyarat
Contoh berikut menunjukkan cara memperbarui acara Kalender secara bersyarat menggunakan
header If-Match
. Skrip 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 acara Kalender secara bersyarat menggunakan
header If-None-Match
. Skrip membuat peristiwa baru, lalu mengumpulkan peristiwa 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 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.