CalDAV API Geliştirici Kılavuzu

CalDAV, istemcilere uzak bir sunucudaki takvim bilgilerine erişme standardı sağlayan bir WebDAV uzantısıdır.

Google, takvimleri CalDAV protokolünü kullanarak görüntülemek ve yönetmek için kullanabileceğiniz bir CalDAV arayüzü sağlar.

Özellikler

İlgili spesifikasyonların her biri için Google'ın CalDAV desteği aşağıdaki gibidir:

İlgili spesifikasyonların tümünün tam olarak uygulanmasını henüz sağlamadık. Ancak, Apple'ın Takvim uygulaması gibi birçok istemci için CalDAV protokolünün düzgün bir şekilde birlikte çalışması gerekir.

Not: Google, hesap güvenliği ve kötüye kullanımı önlemek için, verilere CalDAV aracılığıyla erişen istemci uygulamalarında çerezler ayarlayabilir.

İstemci kimliğiniz oluşturuluyor

CalDAV API'yi kullanmak için bir Google Hesabınızın olması gerekir. Kullanabileceğiniz bir hesabınız varsa hazırsınız demektir.

CalDAV API'ye istek gönderebilmeniz için bir proje oluşturarak istemcinizi Google API Konsolu'na kaydetmeniz gerekir.

Google API Konsolu'na gidin. Create project'i (Proje oluştur) tıklayın, bir ad girin ve Create'i (Oluştur) tıklayın.

Sonraki adım, CalDAV API'yi etkinleştirmektir.

Projenizde bir API'yi etkinleştirmek için şunları yapın:

  1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse bir proje seçin veya yeni bir proje oluşturun. API Kitaplığı'nda, kullanılabilir tüm API'ler ürün ailesine ve popülerliğe göre gruplandırılmış şekilde listelenir.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa bulmak için arama işlevini kullanın.
  3. Etkinleştirmek istediğiniz API'yi seçin, ardından Etkinleştir düğmesini tıklayın.
  4. İstenirse faturalandırmayı etkinleştirin.
  5. İstenirse API'nin Hizmet Şartları'nı kabul edin.
CalDAV API isteklerini gerçekleştirebilmek için İstemci Kimliği ve İstemci Gizli Anahtarı gereklidir.

Projenizin istemci kimliğini ve istemci gizli anahtarını bulmak için şunları yapın:

  1. Mevcut bir OAuth 2.0 kimlik bilgisini seçin veya Kimlik bilgileri sayfasını açın.
  2. Henüz yapmadıysanız Kimlik bilgileri oluştur > OAuth istemci kimliği'ni tıklayarak ve kimlik bilgilerini oluşturmak için gereken bilgileri sağlayarak projenizin OAuth 2.0 kimlik bilgilerini oluşturun.
  3. OAuth 2.0 istemci kimlikleri bölümündeki İstemci Kimliği'ni bulun. Ayrıntılar için istemci kimliğini tıklayın.

Google'ın CalDAV sunucusuna bağlanma

İstemci programı CalDAV arayüzünü kullanmak için ilk olarak iki başlangıç noktasından birinde takvim sunucusuna bağlanır. Her iki durumda da bağlantı HTTPS üzerinden oluşturulmalı ve OAuth 2.0 kimlik doğrulama şemasını kullanmalıdır. CalDAV sunucusu, Google hesabının OAuth 2.0 kimlik doğrulamasıyla HTTPS üzerinden ulaşmadığı durumlarda isteğin kimliğini doğrulamayı reddeder. HTTP üzerinden bağlanmaya veya Temel Kimlik Doğrulama'yı kullanmaya çalışmak HTTP 401 Unauthorized durum koduyla sonuçlanır.

İstemci programı (Apple'ın Takvim uygulaması gibi) başlangıç noktası olarak bir ana koleksiyon gerektirirse bağlanılacak URI şu şekildedir:

https://apidata.googleusercontent.com/caldav/v2/calid/user

Burada calid, erişilecek takvimin "takvim kimliği" ile değiştirilmelidir. Bu erişimi Google Takvim web arayüzünde şu şekilde bulabilirsiniz: Takvim adının yanındaki açılır menüden Takvim Ayarları'nı seçin. Açılan sayfada takvim kimliği, Takvim Adresi etiketli bir bölümde gösterilir. Bir kullanıcının birincil takviminin takvim kimliği, kullanıcının e-posta adresiyle aynıdır.

Bir istemci programı (ör. Mozilla Sunbird) başlangıç noktası olarak bir takvim koleksiyonu gerektirirse bağlanılacak URI şu şekildedir:

https://apidata.googleusercontent.com/caldav/v2/calid/events

Eski uç nokta (https://www.google.com/calendar/dav) kullanımdan kaldırıldı ve artık desteklenmiyor; riski size ait olmak üzere bu uç noktayı kullanabilirsiniz. Yukarıda açıklanan yeni uç nokta biçimine geçmenizi öneririz.

iCal®, Apple Inc.ın ticari markasıdır.