Pengingat & notifikasi

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 yang terakhir tidak sama dengan push notifikasi yang, bukan dikirim kepada pengguna, memberi tahu server lain tentang perubahan kalender.

Untuk 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 untuk setiap peristiwa, menggantikannya dengan kumpulan pengingat.

Pengingat default

Pengingat adalah informasi pribadi, khusus untuk pengguna yang diautentikasi; mereka tidak dibagikan ke 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 daftar metadata yang dibagikan di seluruh pengguna.

Pengingat default juga ditampilkan saat melakukan kueri daftar Peristiwa.

Mengganti pengingat default

Untuk mengganti pengingat default ketika Anda menyisipkan atau mengubah sebuah acara, atur reminders.useDefault ke false dan mengisi reminders.overrides dengan pengaturan pengingat baru.

"reminders": {
  "useDefault": false,
  # Overrides can be set if and only if useDefault is false.
  "overrides": [
      {
        "method": "reminderMethod",
        "minutes": "reminderMinutes"
      },
      # ...
  ]
}

Untuk kembali ke rangkaian pengingat default, lakukan setelan pembaruan reminders.useDefault kembali 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 yang mengundang pengguna.
  • 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 apa yang akan diaktifkan per kalender dan pengiriman untuk setiap jenis notifikasi. Setelan ini tidak dibagikan ke yang lain pelanggan. Mirip dengan pengingat default, pengingat ini dapat diakses melalui daftar Kalender.

Untuk mengirim notifikasi email kepada tamu untuk acara yang telah disisipkan atau diupdate melalui API, setel parameter sendNotifications di insert/update ke 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 Email
Pengingat Pengingat default ✓ ✓
Ganti pengingat ✓ ✓
Notifikasi Pembuatan peristiwa ❌ ✓
Perubahan acara ❌ ✓
Pembatalan acara ❌ ✓
Tanggapan peserta ❌ ✓
Agenda ❌ ✓