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 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
delete 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 (ekle) POST  /calendars/calendarId/acl Erişim denetimi 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 denetimi 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. Belirtilmişse dizi alanları mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
update PUT  /calendars/calendarId/acl/ruleId Erişim denetimi kuralını günceller.
watch POST  /calendars/calendarId/acl/watch ACL kaynaklarındaki değişiklikleri izleyin.

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
delete 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 (ekle) 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. Belirtilmişse dizi alanları mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
update 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.
delete DELETE  /calendars/calendarId İkincil bir takvimi siler. Birincil takvimlerdeki tüm etkinlikleri temizlemek için calendars.clear yöntemini kullanın.
get GET  /calendars/calendarId Bir takvimin meta verilerini döndürür.
insert (ekle) POST  /calendars İkincil bir takvim oluşturur.

İstek için kimliği doğrulanmış kullanıcı, yeni takvimin veri sahibi yapılır.
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. Belirtilmişse dizi alanları mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
transferOwnership POST  /calendars/calendarId/transferOwnership Google Workspace kuruluşundaki kullanıcılar arasında ikincil takvim aktarır. Takvimleri yönetme yönetici ayrıcalığıyla kullanıcı kimlik doğrulaması ve aşağıdaki yetkilendirme kapsamlarından biri gerekir:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
İsteğinde useAdminAccess değerini true olarak ayarlayın. İkincil takvimin aktarılabilmesi için etkin olması gerekir. Devre dışı bırakılmış veya silinmiş takvimlerin aktarılması desteklenmez.

Gerekli sorgu parametreleri: newDataOwner, useAdminAccess

update 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
stop 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

Etkinlikler 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
delete 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 parametresini kullanarak ç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 (ekle) 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. Belirtilmişse dizi alanları 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

update 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.