CalDAV adalah ekstensi WebDAV yang menyediakan standar bagi klien untuk mengakses informasi kalender di server jarak jauh.
Google menyediakan antarmuka CalDAV yang dapat Anda gunakan untuk melihat dan mengelola kalender menggunakan protokol CalDAV.
Spesifikasi
Untuk setiap spesifikasi yang relevan, dukungan CalDAV Google adalah sebagai berikut:
- rfc4918: Ekstensi HTTP untuk Pembuatan dan Pembuatan Versi Web Terdistribusi
(WebDAV)
- Mendukung metode HTTP
GET
,PUT
,HEAD
,DELETE
,POST
,OPTIONS
,PROPFIND
, danPROPPATCH
. - Tidak mendukung metode HTTP
LOCK
,UNLOCK
,COPY
,MOVE
, atauMKCOL
, atau headerIf*
(kecuali untukIf-Match
). - Tidak mendukung properti WebDAV arbitrer (ditentukan oleh pengguna).
- Tidak mendukung Kontrol Akses WebDAV (rfc3744).
- Mendukung metode HTTP
- rfc4791: Ekstensi Kalender untuk WebDAV (CalDAV)
- Mendukung metode HTTP
REPORT
. Semua laporan kecuali kueri senggang-sibuk diimplementasikan. - Tidak mendukung metode HTTP
MKCALENDAR
. - Tidak mendukung tindakan
AUDIO
.
- Mendukung metode HTTP
- rfc5545: iKalender
- Data yang ditampilkan di antarmuka CalDAV diformat sesuai dengan spesifikasi iKalender.
- Saat ini tidak mendukung data
VTODO
atauVJOURNAL
. - Tidak mendukung ekstensi Apple iCal® untuk mengizinkan properti URL yang dapat ditetapkan pengguna.
- rfc6578: Sinkronisasi Koleksi untuk WebDAV
- Aplikasi klien harus beralih ke mode operasi ini setelah sinkronisasi awal.
- rfc6638: Menjadwalkan Ekstensi ke CalDAV
- Mendukung "kotak masuk" sederhana yang selalu kosong.
- Undangan yang Anda terima akan otomatis dikirim ke dalam koleksi "acara" Anda, bukan dimasukkan ke "kotak masuk".
- Tidak mendukung pencarian senggang-sibuk.
- caldav-ctag-02: Tag Entitas Koleksi Kalender (CTag) di CalDAV
- Kalender
ctag
seperti fasilitasetag
; dan akan berubah jika ada perubahan dalam kalender. Hal ini memungkinkan aplikasi klien menentukan dengan cepat bahwa aplikasi tidak perlu menyinkronkan setiap peristiwa yang berubah.
- Kalender
- calendar-proxy: Fungsi Proxy Pengguna Kalender di CalDAV
- Untuk meningkatkan performa sinkronisasi kalender dari perangkat iOS yang tidak mendukung delegasi, penggunaan properti
calendar-proxy-read-for
ataucalendar-proxy-write-for
dengan UserAgent iOS akan gagal.
- Untuk meningkatkan performa sinkronisasi kalender dari perangkat iOS yang tidak mendukung delegasi, penggunaan properti
Kami belum memberikan implementasi penuh dari semua spesifikasi yang relevan. Namun, bagi banyak klien seperti aplikasi Calendar Apple, protokol CalDAV seharusnya dapat saling beroperasi dengan benar.
Catatan: Untuk keamanan akun dan mencegah penyalahgunaan, Google mungkin menetapkan cookie pada aplikasi klien yang mengakses data melalui CalDAV.
Membuat client ID
Untuk menggunakan CalDAV API, Anda harus memiliki Akun Google. Jika sudah memiliki akun yang dapat digunakan, berarti Anda sudah siap.
Sebelum dapat mengirim permintaan ke CalDAV API, Anda harus mendaftarkan klien ke Konsol API Google dengan membuat project.
Buka Konsol Google API. Klik Buat project, masukkan nama, lalu klik Buat.
Langkah berikutnya adalah mengaktifkan CalDAV API.Untuk mengaktifkan API untuk project Anda, lakukan hal berikut:
- Buka API Library di Konsol API Google. Jika diminta, pilih project atau buat yang baru. Library API mencantumkan semua API yang tersedia, yang dikelompokkan berdasarkan kelompok produk dan popularitas.
- Jika API yang ingin Anda aktifkan tidak terlihat dalam daftar, gunakan penelusuran untuk mencarinya.
- Pilih API yang ingin Anda aktifkan, lalu klik tombol Enable.
- Jika diminta, aktifkan penagihan.
- Jika diminta, setujui Persyaratan Layanan API.
Untuk menemukan client ID dan rahasia klien project Anda, lakukan hal berikut:
- Pilih kredensial OAuth 2.0 yang sudah ada atau buka halaman Credentials.
- Jika belum melakukannya, buat kredensial OAuth 2.0 project Anda dengan mengklik Create credentials > OAuth client ID, lalu berikan informasi yang diperlukan untuk membuat kredensial.
- Cari Client ID di bagian OAuth 2.0 client ID. Untuk mengetahui detailnya, klik client ID.
Menghubungkan ke server CalDAV Google
Untuk menggunakan antarmuka CalDAV, program klien awalnya terhubung dengan
server kalender di salah satu dari dua titik awal. Dalam kedua kasus tersebut, koneksi
harus dibuat melalui HTTPS dan harus menggunakan skema autentikasi
OAuth 2.0. Server CalDAV akan menolak untuk mengautentikasi permintaan,
kecuali jika permintaan tersebut diterima melalui HTTPS dengan autentikasi OAuth 2.0 dari Akun Google.
Mencoba terhubung melalui HTTP atau menggunakan Autentikasi Dasar akan menghasilkan kode status
HTTP 401 Unauthorized
.
Jika program klien (seperti aplikasi Calendar Apple) memerlukan koleksi utama sebagai titik awal, URI yang akan dihubungkan adalah:
https://apidata.googleusercontent.com/caldav/v2/calid/user
calid
harus diganti dengan
"ID kalender" kalender yang akan diakses. Ini dapat ditemukan melalui
antarmuka web Google Kalender sebagai berikut: di menu pull-down di samping
nama kalender, pilih Setelan Kalender. Pada halaman yang dihasilkan,
ID kalender akan ditampilkan di bagian berlabel Alamat
Kalender. ID kalender untuk kalender utama pengguna sama dengan
alamat email pengguna tersebut.
Jika program klien (seperti Mozilla Sunbird) memerlukan koleksi kalender sebagai titik awal, URI yang akan dihubungkan adalah:
https://apidata.googleusercontent.com/caldav/v2/calid/events
Endpoint lama https://www.google.com/calendar/dav tidak digunakan lagi dan tidak lagi didukung; Anda harus menanggung sendiri risikonya. Sebaiknya Anda beralih ke format endpoint baru yang dijelaskan di atas.
iCal® adalah merek dagang Apple Inc.