CalendarList: list

Kullanıcının takvim listesinde bulunan takvimleri döndürür. Şimdi deneyin.

İstek

HTTP isteği

GET https://www.googleapis.com/calendar/v3/users/me/calendarList

Parametreler

Parametre adı Değer Açıklama
İsteğe bağlı sorgu parametreleri
maxResults integer Tek bir sonuç sayfasında döndürülen maksimum giriş sayısı. Varsayılan değer 100 giriştir. Sayfa boyutu hiçbir zaman 250 girişten büyük olamaz. İsteğe bağlı.
minAccessRole string Döndürülen girişlerdeki kullanıcı için minimum erişim rolü. İsteğe bağlı. Varsayılan olarak kısıtlama yoktur.

Kabul edilen değerler şunlardır:
  • "freeBusyReader": Kullanıcı, müsaitlik durumu bilgilerini okuyabilir.
  • "owner": Kullanıcı, etkinlikleri okuyabilir ve değiştirebilir ve denetim listelerine erişebilir.
  • "reader": Kullanıcı, gizli olmayan etkinlikleri okuyabilir.
  • "writer": Kullanıcı etkinlikleri okuyabilir ve değiştirebilir.
pageToken string Döndürülecek sonuç sayfasını belirten jeton. İsteğe bağlı.
showDeleted boolean Silinen takvim listesi girişlerinin sonuca dahil edilip edilmeyeceğini belirtir. İsteğe bağlı. Varsayılan değer False'tır.
showHidden boolean Gizli girişlerin gösterilip gösterilmeyeceği. İsteğe bağlı. Varsayılan değer False'tır.
syncToken string Önceki liste isteğinin sonuçlarının son sayfasında döndürülen nextSyncToken alanından alınan jeton. Bu liste isteği sonucunda yalnızca o tarihten sonra değişen girişler gösterilir. Yalnızca takvim özellikleri veya ACL'ler gibi salt okunur alanlar değiştiyse giriş döndürülmez. Önceki liste isteğinden sonra silinen ve gizlenen tüm girişler her zaman sonuç kümesinde olur ve showDeleted veya showHidden değerinin False olarak ayarlanmasına izin verilmez.
İstemci durumu tutarlılığını sağlamak için minAccessRole sorgu parametresi nextSyncToken ile birlikte belirtilemez.
syncToken'ın süresi dolarsa sunucu 410 GİTTİ yanıt koduyla yanıt verir ve istemci, depolama alanını temizleyip syncToken olmadan tam senkronizasyon yapmalıdır. Artımlı senkronizasyon hakkında
daha fazla bilgi edinin.
İsteğe bağlı. Varsayılan olarak tüm girişler döndürülür.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir:

Kapsam
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.calendarlist
https://www.googleapis.com/auth/calendar.calendarlist.readonly

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasına bakın.

İstek içeriği

Bu yöntemle istek gövdesi göndermeyin.

Yanıt

Başarılı olursa bu yöntem aşağıdaki yapıya sahip bir yanıt metni döndürür:

{
  "kind": "calendar#calendarList",
  "etag": etag,
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    calendarList Resource
  ]
}
Mülk adı Değer Açıklama Notlar
kind string Koleksiyonun türü ("calendar#calendarList").
etag etag Koleksiyonun ETag'ı.
nextPageToken string Bu sonucun bir sonraki sayfasına erişmek için kullanılan jeton. Başka sonuç yoksa atlanır. Bu durumda nextSyncToken sağlanır.
items[] list Kullanıcının takvim listesinde bulunan takvimler.
nextSyncToken string Bu sonuç döndürüldükten sonra yalnızca değişen girişleri almak için daha sonraki bir zamanda kullanılan jeton. Başka sonuçlar varsa atlanır. Bu durumda nextPageToken sağlanır.

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.