CalDAV API Geliştirici Kılavuzu

CalDAV, WebDAV'ın bir uzantısıdır ve istemciler arasında bağlantı kurmak için takvim bilgilerini kullanır.

Google, takvimleri görüntülemek ve yönetmek için kullanabileceğiniz bir CalDAV arayüzü sağlar (CalDAV protokolü kullanılarak)

Özellikler

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

Bu politikalarla alakalı tüm mevcut ve olası satışları henüz özellikler. Ancak, Apple'ın Takvim uygulaması gibi birçok istemci için CalDAV protokolü doğru şekilde birlikte çalışacaktır.

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

İstemci kimliğiniz oluşturuluyor

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

CalDAV API'ye istek gönderebilmek için istemcinizi Google API Konsolu'yla test etmek için yeni bir proje oluşturun.

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

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

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

  1. Google API Konsolu'nda API Kitaplığı'nı açın. İstenirse, yeni bir proje oluşturabilirsiniz. API kitaplığında mevcut tüm Ürün ailesine ve popülerliğe göre gruplandırılmış API'ler.
  2. Etkinleştirmek istediğiniz API listede görünmüyorsa aramayı kullanarak onu bulacağım.
  3. Etkinleştirmek istediğiniz API'yi seçin ve ardından Etkinleştir'i tıklayın. 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 gerekenler Client ID (İstemci Kimliği) ve Client Secret (İstemci Gizli Anahtarı).

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

  1. Mevcut bir OAuth 2.0 seçin kimlik bilgisi'ni tıklayın veya Kimlik bilgileri sayfasını açın.
  2. Henüz yapmadıysanız projenizin OAuth 2.0'ını oluşturun. Kimlik bilgileri oluştur > OAuth istemci kimliği ve ve kimlik bilgilerini oluşturmak için gereken bilgileri sağlar.
  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ğlanılıyor

CalDAV arayüzünü kullanmak için, bir istemci programı başlangıçta iki başlangıç noktasından birine dönüştürün. Her iki durumda da bağlantı HTTPS üzerinden yapılmalı ve OAuth 2.0 kullanılmalıdır. kimlik doğrulama şeması. CalDAV sunucusu isteği kimlik doğrulamasını reddedecek bir Google hesabının OAuth 2.0 kimlik doğrulamasıyla HTTPS üzerinden ulaşmadığı sürece. HTTP üzerinden veya Temel Kimlik Doğrulaması kullanarak bağlanmaya çalışılması, HTTP ile sonuçlanır 401 Unauthorized durum kodu.

İstemci programı (Apple'ın Takvim uygulaması gibi) için bir ana koleksiyonun başlangıç noktası olarak ayarlanmasını istiyorsanız, bağlanılacak URI şöyle olmalıdır:

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

calid öğesinin, "takvim kimliği" seçin. Bu bilgiye şuradan ulaşabilirsiniz: Google Takvim web arayüzü şu şekildedir: takvim adının altında Takvim Ayarları'nı seçin. Açılan sayfada takvim kimliği Takvim Adres. Kullanıcının birincil takviminin takvim kimliği kullanıcının e-posta adresi.

Müşteri programı (örneğin, Mozilla Sunbird) başlangıç noktası olarak bir takvim koleksiyonu seçin. Bağlanılacak URI şudur:

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

Eski uç nokta https://www.google.com/calendar/dav desteği sonlandırıldı ve artık desteklenmiyor; kullanmanızdan kaynaklanan riskleri üstlenmeniz gerekir. Yukarıda açıklanan yeni uç nokta biçimine geçmenizi öneririz.

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