Pengingat & notifikasi

Calendar API memberikan 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 boleh disamakan dengan notifikasi push yang, alih-alih dikirim kepada pengguna, memberi tahu server lain tentang perubahan pada kalender.

Untuk mengetahui detail selengkapnya tentang notifikasi di Google Kalender, buka Mengubah notifikasi Google Kalender.

Pengingat

Pengingat terdiri dari:

  • Waktu untuk menampilkan pengingat, dinyatakan dalam menit sebelum waktu mulai acara
  • Metode pengiriman yang akan digunakan (lihat Mekanisme pengiriman)

Pengingat dapat ditentukan untuk seluruh kalender dan untuk setiap 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 default ini untuk setiap acara, menggantinya dengan kumpulan pengingat yang berbeda.

Pengingat default

Pengingat adalah informasi pribadi, khusus untuk pengguna yang diautentikasi; pengingat tidak dibagikan di beberapa pengguna. Hasilnya:

  • Pengingat default dimanipulasi melalui koleksi CalendarList, yang berisi metadata kalender khusus pengguna
  • Data tersebut tidak dapat diakses melalui koleksi Kalender, yang berisi metadata global yang dibagikan kepada semua pengguna.

Pengingat default juga ditampilkan saat melakukan kueri daftar Peristiwa.

Mengganti pengingat default

Untuk mengganti pengingat default saat Anda menyisipkan atau mengubah peristiwa, tetapkan reminders.useDefault ke false dan isi reminders.overrides dengan kumpulan pengingat baru.

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

Untuk kembali ke kumpulan pengingat default, lakukan pembaruan setelan 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 diundang pengguna.
  • Pembatalan acara: acara yang diundang pengguna dibatalkan.
  • Respons tamu: tamu pada 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 dibagikan kepada pengguna lain. Serupa dengan pengingat default, pengingat ini dapat diakses melalui koleksi CalendarList.

Untuk mengirim notifikasi email kepada peserta untuk peristiwa yang disisipkan atau diperbarui melalui API, tetapkan parameter sendNotifications dalam permintaan sisipkan/perbarui ke benar (true).

Mekanisme pengiriman

Metode pengiriman yang ditawarkan oleh Google Kalender adalah:

  • Pop-up. Fitur ini didukung di platform seluler dan di klien web.
  • Email yang dikirim oleh server.

Tabel berikut menunjukkan metode yang didukung untuk setiap jenis pengingat atau notifikasi:

Munculan Email
Pengingat Pengingat default ✓ ✓
Mengganti pengingat ✓ ✓
Notifikasi Pembuatan peristiwa ❌ ✓
Perubahan peristiwa ❌ ✓
Pembatalan acara ❌ ✓
Respons tamu ❌ ✓
Agenda ❌ ✓