CalDAV API Geliştirici Kılavuzu

CalDAV, istemcilerin uzak bir sunucudaki takvim bilgilerine erişmesi için standart sağlayan WebDAV'nin bir uzantısıdır.

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

Özellikler

Aşağıda, ilgili özelliklerin her biri için Google'ın CalDAV desteği verilmiştir:

Henüz ilgili tüm özelliklerin tam olarak uygulanmasını sağlamadık. Ancak Apple'ın Takvim uygulaması gibi birçok istemci için CalDAV protokolü doğru şekilde çalışmalıdır.

Not: Google, hesap güvenliğini sağlamak ve kötüye kullanımı önlemek için CalDAV üzerinden verilere erişen istemci uygulamalarında çerez ayarlayabilir.

İstemci kimliğinizi oluşturma

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

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

Google API Konsolu'na gidin. Proje oluştur'u tıklayın, bir ad girin ve Oluştur'u tıklayın.

Sonraki adımda CalDAV API'yi etkinleştirin.

Projeniz için bir API'yi etkinleştirmek üzere şunları yapın:

  1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse bir proje seçin veya yeni proje oluşturun. API Kitaplığı, mevcut tüm API'leri ürün ailesine ve popülerliğe göre gruplandırarak listeler.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa aramayı kullanarak API'yi bulun.
  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ştirmek için istemci kimliği ve istemci gizli anahtarı gerekir.

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

  1. Mevcut bir OAuth 2.0 kimlik bilgisi 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ıklayıp 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ünde İstemci Kimliği'ni bulun. Ayrıntılar için istemci kimliğini tıklayın.

Google'ın CalDAV sunucusuna bağlanma

CalDAV arayüzünü kullanmak için istemci programları başlangıçta iki başlangıç noktasından birinde takvim sunucusuna bağlanır. Her iki durumda da bağlantı HTTPS üzerinden kurulmalı ve OAuth 2.0 kimlik doğrulama şeması kullanılmalıdır. CalDAV sunucusu, bir Google hesabının OAuth 2.0 kimlik doğrulamasıyla HTTPS üzerinden gelmediği sürece isteğin kimliğini doğrulamayı reddeder. HTTP üzerinden veya Temel Kimlik Doğrulama kullanılarak bağlantı kurulmaya çalışıldığında HTTP 401 Unauthorized durum kodu döndürülür.

İstemci programı (ör. Apple'ın Takvim uygulaması) başlangıç noktası olarak bir ana koleksiyon gerektiriyorsa bağlanılacak URI şudur:

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

Bu durumda calid, erişilecek takvimin "takvim kimliği" ile değiştirilmelidir. Bu ayara Google Takvim web arayüzünden şu şekilde ulaşabilirsiniz: Takvim adının yanındaki açılır menüden Takvim Ayarları'nı seçin. Açılan sayfada, takvim kimliği Takvim Adresi adlı bir bölümde gösterilir. 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 gerektiriyorsa bağlanılacak URI şudur:

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. Bu uç noktayı kullanma riski size aittir. Yukarıda açıklanan yeni uç nokta biçimine geçmenizi öneririz.

iCal®, Apple Inc. şirketinin ticari markasıdır.