Apa itu Google Calendar API
Cara Menggunakannya
- Buat acara. Google Calendar adalah alat hebat untuk membantu pengguna tetap terorganisir. Menggunakannya, Anda bisa, misalnya, menambahkan rute pendakian sebagai acara kalender dan mengingatkan setiap peserta agar mereka tetap siap tanpa stres.
- Acara Berulang. Beberapa acara terjadi berkali-kali – rapat harian, ulang tahun, atau libur. Biasanya mereka identik dan memiliki waktu mulai serta selesai yang sama.
- Sinkronkan Sumber Daya. Anda bisa menjaga data untuk semua koleksi kalender tetap sinkron, menghemat bandwidth.
- Terapkan notifikasi push. Ada kemungkinan menggunakan notifikasi push yang memberi tahu aplikasi Anda ketika sebuah sumber berubah.
- Sinkronkan sumber daya. Google Calendar API dapat membantu Anda menjaga agar data untuk semua koleksi kalender tetap sinkron sambil menghemat bandwidth.
- Acara – sebuah fitur pada kalender yang memuat judul, waktu mulai dan selesai, serta peserta.
- Kalender – kumpulan acara.
- Kalender list – daftar semua kalender di antarmuka Kalender
- Pengaturan – preferensi dari UI Kalender seperti zona waktu pengguna.
- ACL – sebuah aturan kontrol akses yang memberikan seorang pengguna tingkat akses khusus ke sebuah kalender.
- Warna – warna yang ditampilkan dalam antarmuka Kalender
- Free/busy – waktu-waktu ketika kalender memiliki acara yang dijadwalkan sebagai “sibuk” atau tidak ada acara dan dianggap “tersedia”.
Gunakan API Kalender
Setiap permintaan yang dikirim aplikasi Anda ke Calendar API v3 memerlukan token otorisasi. Token ini juga mengidentifikasi aplikasi untuk Google. Aplikasi harus menggunakan OAuth 2.0 untuk mengotorisasi permintaan—protokol otorisasi lainnya tidak didukung.
- Saat membuat aplikasi, daftarkan menggunakan Google Calendar API Console. Google akan memberikan Anda ID klien dan Rahasia klien. Anda akan membutuhkannya nanti.
- Aktifkan Google Calendar API di API Console. Jika tidak terdaftar di sana, lewati langkah ini.
- Ketika aplikasi Anda membutuhkan akses ke data pengguna, ia meminta Google untuk lingkup akses tertentu.
- Selanjutnya Google menampilkan layar persetujuan kepada pengguna, meminta mereka untuk mengizinkan aplikasi Anda mengakses sebagian informasinya.
- Jika pengguna memberikan persetujuan, Google memberikan aplikasi Anda token akses berjangka pendek.
- Lalu aplikasi Anda meminta data pengguna dan menyertakan token pada permintaan.
- Jika Google menentukan permintaan dan token Anda sebagai valid, Google mengembalikan data yang diminta.
Kadang-kadang Anda mungkin membutuhkan langkah tambahan, misalnya menggunakan refresh token untuk mendapatkan token akses baru. Anda bisa memeriksa prosesnya untuk berbagai jenis aplikasi di sini.
Jika Anda akan beruntung dan disetujui, Anda akan mendapatkan akses ke dokumentasi Calendar API sehingga Anda dapat memulai pengembangan perangkat lunak terintegrasi Anda.
Jika Anda membutuhkan cara sederhana dan cepat untuk menambahkan Kalender ke situs Anda, pertimbangkan Event Calendar dari Elfsight. Ini memberi Anda peluang menampilkan acara Anda di SERP Google tanpa usaha.
API Kalender: Contoh
Buat acara lewat Google Calendar API
- calendarId – ini adalah identitas kalender yang bisa berupa alamat email kalender tempat Anda akan membuat acara, atau kata kunci khusus ‘primary’ yang akan menggunakan kalender utama milik pengguna yang sedang masuk.
- Acara adalah entri yang akan dibuat dengan semua informasi yang diperlukan, seperti waktu mulai dan selesai. Dua kolom yang diperlukan di sini hanyalah waktu mulai dan waktu selesai.
Berikut contoh yang menunjukkan proses membuat acara dan mengatur metadata-nya:
Contoh: proses membuat sebuah acara
API Acara Berulang
Acara ini berlangsung beberapa kali secara teratur, misalnya pertemuan harian, ulang tahun, atau hari libur. Berikut contoh acara yang berlangsung dari pukul 06:00 hingga 07:00 setiap Selasa dan Jumat mulai 15 September 2015 dan berhenti setelah kejadian kelima pada 29 September:
Contoh: acara berulang
Di sini kita bisa melihat acara sepanjang hari yang dimulai pada 1 Juni 2015 dan berulang setiap 3 hari sepanjang bulan ini, kecuali 10 Juni tetapi termasuk 9 Juni dan 11 Juni:
Contoh: Acara Berulang Sepanjang Hari
Sinkronkan Sumber Daya
Metode ini membantu Anda menjaga agar data untuk semua koleksi kalender tetap sinkron. Sinkronisasi inkremental terdiri dari dua tahap:
- Sinkronisasi penuh awal dilakukan satu kali di awal untuk menyelaraskan keadaan klien dan keadaan server secara penuh.
- Sinkronisasi inkremental dilakukan berulang-ulang, memperbarui klien dengan semua perubahan yang terjadi sejak pembaruan sebelumnya.
Berikut contoh token sinkronisasi:
Contoh: token sinkronisasi
Notifikasi Push
Google Calendar API v3 memberi Anda kesempatan untuk menerima notifikasi push yang memungkinkan Anda memantau perubahan sumber daya. Fitur ini bisa Anda manfaatkan untuk meningkatkan aplikasi Anda.
Anda membutuhkan tiga hal untuk mulai menggunakan notifikasi push:
- Daftarkan domain URL penerima Anda.
- Siapkan URL penerimaan Anda atau penerima callback “Webhook”.
- Siapkan saluran notifikasi untuk setiap endpoint sumber daya yang akan Anda awasi.
Contoh di bawah ini menunjukkan bagaimana Anda bisa mulai memantau perubahan pada sekumpulan acara:
Contoh: memantau perubahan pada kumpulan acara
Batasan Calendar API
Batas permintaan harian Calendar API adalah 1.000.000. Jika Anda ingin mengubah batas penggunaan atau meningkatkan kuota Anda, lakukan langkah berikut:
- Buat akun penagihan jika Anda belum memilikinya.
- Buka halaman API yang Diaktifkan pada pustaka API di Google Console dan pilih API dari daftarnya.
- Pilih Kuota untuk melihat dan mengubah pengaturan terkait kuota.
Ada widget lain yang membantu Anda memanfaatkan data dari platform. Salah satu yang paling bermanfaat untuk setiap bisnis adalah Google Reviews widget. Fungsionalitasnya sangat luas, tidak hanya memungkinkan Anda embed Google reviews, tetapi juga membuat rich snippets untuk hasil pencarian.
Pertanyaan Umum
Apakah Google Calendar API gratis?
Ya, penggunaan Google Calendar API gratis. Namun, ada beberapa batasan.
Bagaimana saya bisa membuat acara dengan bantuan Calendar API?
Anda perlu memanggil metode events.insert(), dengan calendarId dan parameter event. Anda juga perlu mengatur scope OAuth Anda ke https://www.googleapis.com/auth/calendar dan memastikan pengguna yang terotorisasi memiliki hak tulis ke kalender dengan calendarId yang Anda berikan.
Bagaimana saya bisa mendapatkan data dari Google Calendar?
Buka Kalender Anda, lalu klik bagian “Kalender Saya”. Pilih kalender yang ingin Anda ekspor, kemudian klik “Lainnya”. Di Pengaturan Kalender, klik “Ekspor Kalender”. Kemudian ICS berisi acara Anda akan mulai diunduh.
Bisakah Kalender saya dicadangkan secara otomatis?
Tentu. Untuk melakukannya, buka tab Kalender, lalu klik tombol “Lainnya” dan pilih “Jalankan cadangan” dari daftar dropdown, cadangan akan mulai secara otomatis.
Bagaimana cara menemukan API Google Calendar saya?
Buka Google Developer Console dan buat proyek baru. Di dalam proyek, buka API & Otentikasi > API di bilah sisi. Lalu temukan Calendar API dalam daftar.
Kesimpulan
