Pengingat dan notifikasi

Google 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.

Jangan bingung antara notifikasi dan notifikasi push, yang memberi tahu server lain tentang perubahan pada kalender, bukan dikirimkan kepada pengguna.

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

Pengingat

Pengingat terdiri dari:

  • Kapan pengingat akan ditampilkan, yang dinyatakan dalam menit sebelum waktu mulai acara.
  • Metode pengiriman yang akan digunakan (lihat Mekanisme pengiriman).

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

Pengingat default

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

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

Pengingat default juga ditampilkan saat melakukan kueri Daftar acara.

Mengganti pengingat default

Untuk mengganti pengingat default saat Anda membuat atau memperbarui acara, tetapkan reminders.useDefault ke false dan isi reminders.overrides dengan kumpulan pengingat baru. Penggantian hanya dapat ditetapkan jika useDefault adalah false, seperti yang ditunjukkan dalam contoh berikut:

"reminders": {
  "useDefault": false,
  "overrides": [
    {
      "method": "reminderMethod",
      "minutes": "reminderMinutes"
    }
  ]
}

Untuk kembali ke kumpulan pengingat default, lakukan setelan update 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 yang mengundang pengguna dibatalkan.
  • Respons tamu: Tamu mengubah status responsnya untuk acara yang dibuat oleh pengguna.
  • Agenda: Daftar semua acara di kalender pengguna, yang dikirim pada awal hari.

Pengguna dapat memutuskan notifikasi mana yang akan diaktifkan per kalender dan metode pengiriman untuk setiap jenis notifikasi. Setelan ini tidak dibagikan kepada pengguna lain. Mirip dengan pengingat default, setelan ini dapat diakses melalui koleksi CalendarList.

Untuk mengirim notifikasi email kepada tamu untuk acara yang disisipkan atau diperbarui dengan API, panggil metode insert atau update dan tetapkan parameter sendUpdates ke "all" atau "externalOnly".

Mekanisme pengiriman

Metode pengiriman yang ditawarkan oleh Google Kalender adalah:

  • Pop-up. Metode 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:

Pop-up Email
Pengingat Pengingat default ✓ ✓
Ganti pengingat ✓ ✓
Notifikasi Pembuatan acara ❌ ✓
Perubahan acara ❌ ✓
Pembatalan acara ❌ ✓
Respons tamu ❌ ✓
Agenda ❌ ✓