Calendar API menyediakan dukungan untuk pengingat dan notifikasi.
- Pengingat adalah alarm yang dipicu pada waktu tertentu sebelum acara dimulai.
- Notifikasi memungkinkan pengguna mengetahui perubahan pada acara di kalender mereka.
Item terakhir tidak sama dengan notifikasi push yang, bukan dikirim ke pengguna, memberi tahu server lain tentang perubahan ke kalender.
Untuk mengetahui detail selengkapnya tentang notifikasi di Google Kalender, buka Mengubah notifikasi Google Kalender.
Pengingat
Pengingat terdiri dari:
- Waktu menampilkan pengingat, yang dinyatakan sebagai menit sebelum waktu mulai acara
- Metode pengiriman yang akan digunakan (lihat Mekanisme pengiriman)
Pengingat dapat ditetapkan untuk keseluruhan kalender dan untuk masing-masing acara. Pengguna dapat menyetel pengingat default untuk setiap kalender mereka; setelan default ini berlaku untuk semua acara dalam kalender tersebut. Namun, pengguna juga dapat mengganti setelan default ini untuk setiap peristiwa, dengan menggantinya dengan kumpulan pengingat yang berbeda.
Pengingat default
Pengingat adalah informasi pribadi, khusus untuk pengguna yang diautentikasi; tidak dibagikan kepada beberapa pengguna. Hasilnya:
- Pengingat default dimanipulasi melalui koleksi CalendarList, yang berisi metadata kalender khusus pengguna
- Kalender tersebut tidak dapat diakses melalui koleksi Kalender, yang berisi metadata global yang dibagikan dengan semua pengguna.
Pengingat default juga ditampilkan saat melakukan kueri daftar Peristiwa.
Mengganti pengingat default
Untuk mengganti pengingat default saat Anda menyisipkan atau mengubah peristiwa, setel
reminders.useDefault
ke false
dan isi
reminders.overrides
dengan pengingat yang baru.
"reminders": {
"useDefault": false,
# Overrides can be set if and only if useDefault is false.
"overrides": [
{
"method": "reminderMethod",
"minutes": "reminderMinutes"
},
# ...
]
}
Untuk mengembalikan ke kumpulan pengingat default, lakukan perubahan setelan
reminders.useDefault
ke true
.
Notifikasi
Kalender mendukung jenis notifikasi berikut:
- Pembuatan acara: acara baru ditambahkan ke salah satu kalender pengguna.
- Perubahan acara: penyelenggara mengubah acara yang mengundang pengguna.
- Pembatalan acara: acara dibatalkan tempat pengguna diundang.
- Tanggapan tamu: tamu acara yang dibuat oleh pengguna mengubah status responsnya.
- Agenda: daftar semua acara di kalender pengguna, yang dikirim pada awal hari.
Pengguna dapat memutuskan notifikasi yang akan diaktifkan per kalender dan metode pengiriman untuk setiap jenis notifikasi. Setelan ini tidak digunakan bersama pengguna lain. Mirip dengan pengingat default, pengingat dapat diakses melalui koleksi CalendarList.
Untuk mengirim notifikasi email kepada tamu terkait peristiwa yang disisipkan atau
diperbarui melalui API, tetapkan parameter sendNotifications
di permintaan penyisipan/pembaruan
ke benar (true).
Mekanisme pengiriman
Metode pengiriman yang ditawarkan oleh Google Kalender adalah:
- Pop-up. Fitur ini didukung di platform seluler dan klien web.
- Email yang dikirim oleh server.
Tabel berikut menunjukkan metode yang didukung untuk setiap pengingat atau jenis notifikasi:
Munculan | |||
---|---|---|---|
Pengingat | Pengingat default | ✓ | ✓ |
Ganti pengingat | ✓ | ✓ | |
Notifikasi | Pembuatan peristiwa | ❌ | ✓ |
Perubahan acara | ❌ | ✓ | |
Pembatalan acara | ❌ | ✓ | |
Tanggapan peserta | ❌ | ✓ | |
Agenda | ❌ | ✓ |