API Reference

Bu API referansı, kaynak türüne göre düzenlenmiştir. Her kaynak türünün bir veya daha fazla veri temsili ve bir veya daha fazla yöntemi vardır.

Kaynak türleri

  1. Acl
  2. CalendarList
  3. Takvimler
  4. Kanallar
  5. Renkler
  6. Etkinlikler
  7. Freebusy
  8. Ayarlar

Acl

Acl Resource ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
sil DELETE  /calendars/calendarId/acl/ruleId Erişim denetimi kuralını siler.
get GET  /calendars/calendarId/acl/ruleId Bir erişim denetimi kuralı döndürür.
insert POST  /calendars/calendarId/acl Erişim kontrolü kuralı oluşturur.
list GET  /calendars/calendarId/acl Takvimin erişim kontrol listesindeki kuralları döndürür.
patch PATCH  /calendars/calendarId/acl/ruleId Erişim kontrolü kuralını günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
güncelleme PUT  /calendars/calendarId/acl/ruleId Erişim kontrolü kuralını günceller.
watch POST  /calendars/calendarId/acl/watch ACL kaynaklarında değişiklik olup olmadığını kontrol edin.

CalendarList

CalendarList Kaynağı ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
sil DELETE  /users/me/calendarList/calendarId Kullanıcının takvim listesinden bir takvimi kaldırır.
get GET  /users/me/calendarList/calendarId Kullanıcının takvim listesinden bir takvim döndürür.
insert POST  /users/me/calendarList Mevcut bir takvimi kullanıcının takvim listesine ekler.
list GET  /users/me/calendarList Kullanıcının takvim listesindeki takvimleri döndürür.
patch PATCH  /users/me/calendarList/calendarId Kullanıcının takvim listesindeki mevcut bir takvimi günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
güncelleme PUT  /users/me/calendarList/calendarId Kullanıcının takvim listesindeki mevcut bir takvimi günceller.
watch POST  /users/me/calendarList/watch CalendarList kaynaklarındaki değişiklikleri izleyin.

Takvimler

Takvim kaynağı ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
temizle POST  /calendars/calendarId/clear Birincil takvimi temizler. Bu işlem, bir hesabın birincil takvimiyle ilişkili tüm etkinlikleri siler.
sil DELETE  /calendars/calendarId İkincil bir takvimi siler. Birincil takvimlerdeki tüm etkinlikleri temizlemek için calendars.clear'ı kullanın.
get GET  /calendars/calendarId Bir takvimin meta verilerini döndürür.
insert POST  /calendars İkincil bir takvim oluşturur.

İstek için kimliği doğrulanmış kullanıcı, yeni takvimin veri sahibi olur.
patch PATCH  /calendars/calendarId Bir takvimin meta verilerini günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
güncelleme PUT  /calendars/calendarId Bir takvimin meta verilerini günceller.

Kanallar

Channels Resource ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
durdur POST  /channels/stop Bu kanal üzerinden kaynak izlemeyi durdurun.

Renkler

Colors Resource ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
get GET  /colors Takvimler ve etkinlikler için renk tanımlarını döndürür.

Etkinlikler

Etkinlik Kaynağı ayrıntıları için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
sil DELETE  /calendars/calendarId/events/eventId Etkinlik siler.
get GET  /calendars/calendarId/events/eventId Google Takvim kimliğine göre bir etkinlik döndürür. Bir etkinliği iCalendar kimliğini kullanarak almak için events.list yöntemini iCalUID parametresiyle birlikte çağırın.
import POST  /calendars/calendarId/events/import Bir etkinliği içe aktarır. Bu işlem, mevcut bir etkinliğin özel kopyasını takvime eklemek için kullanılır. Yalnızca eventType değeri default olan etkinlikler içe aktarılabilir.

Kullanımdan kaldırılan davranış: default olmayan bir etkinlik içe aktarılırsa türü default olarak değiştirilir ve sahip olabileceği etkinliğe özgü tüm özellikler bırakılır.
insert POST  /calendars/calendarId/events Etkinlik oluşturur.
örnekler GET  /calendars/calendarId/events/eventId/instances Belirtilen düzenli etkinliğin örneklerini döndürür.
list GET  /calendars/calendarId/events Belirtilen takvimdeki etkinlikleri döndürür.
move POST  /calendars/calendarId/events/eventId/move Bir etkinliği başka bir takvime taşır (ör. etkinliğin düzenleyicisini değiştirir). Yalnızca default etkinliklerinin taşınabileceğini, birthday, focusTime, fromGmail, outOfOffice ve workingLocation etkinliklerinin taşınamayacağını unutmayın.

Gerekli sorgu parametreleri: destination

patch PATCH  /calendars/calendarId/events/eventId Bir etkinliği günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
quickAdd POST  /calendars/calendarId/events/quickAdd Basit bir metin dizesine dayalı etkinlik oluşturur.

Gerekli sorgu parametreleri: text

güncelleme PUT  /calendars/calendarId/events/eventId Bir etkinliği günceller. Bu yöntem, yama semantiğini desteklemez ve her zaman tüm etkinlik kaynağını günceller. Kısmi güncelleme yapmak için atomikliği sağlamak üzere etag'leri kullanarak get ve ardından update işlemi gerçekleştirin.
watch POST  /calendars/calendarId/events/watch Etkinlik kaynaklarında yapılan değişiklikleri izleyin.

Uygun/Meşgul

Boş/meşgul kaynak ayrıntıları için kaynak temsili sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
query POST  /freeBusy Bir grup takvimin uygun/meşgul bilgilerini döndürür.

Ayarlar

Ayarlar kaynağıyla ilgili ayrıntılar için kaynak gösterimi sayfasına bakın.

Yöntem HTTP isteği Açıklama
Aksi belirtilmediği sürece, https://www.googleapis.com/calendar/v3 ile ilgili URI'ler
get GET  /users/me/settings/setting Tek bir kullanıcı ayarını döndürür.
list GET  /users/me/settings Kimliği doğrulanmış kullanıcının tüm kullanıcı ayarlarını döndürür.
watch POST  /users/me/settings/watch Ayarlar kaynaklarındaki değişiklikleri takip edin.