CalendarList: list

Kullanıcının takvim listesindeki 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 Bir sonuç sayfasında döndürülen maksimum giriş sayısı. Varsayılan olarak bu değer 100 giriş olarak ayarlanır. 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ı, uygun/meşgul bilgilerini okuyabilir.
  • "owner": Kullanıcı, etkinlikleri ve erişim kontrol listelerini okuyup değiştirebilir.
  • "reader": Kullanıcı, gizli olmayan etkinlikleri okuyabilir.
  • "writer": Kullanıcı, etkinlikleri okuyabilir ve değiştirebilir.
  • "writerWithoutPrivateAccess": Kullanıcı, etkinlikleri okuyabilir ve değiştirebilir ancak özel etkinliklere erişemez.
pageToken string Hangi sonuç sayfasının döndürüleceğini belirten jeton. İsteğe bağlı.
showDeleted boolean Silinen takvim listesi girişlerinin sonuca dahil edilip edilmeyeceği. İsteğe bağlı. Varsayılan değer False'tur.
showHidden boolean Gizli girişlerin gösterilip gösterilmeyeceği. İsteğe bağlı. Varsayılan değer False'tur.
syncToken string Önceki liste isteğinden elde edilen sonuçların son sayfasında döndürülen nextSyncToken alanından alınan jeton. Bu, liste isteğinin sonucunun yalnızca o zamandan beri değişen girişleri içermesini sağlar. Yalnızca takvim özellikleri veya ACL'ler gibi salt okunur alanlar değiştiyse giriş döndürülmez. Önceki liste isteğinden bu yana silinen ve gizlenen tüm girişler her zaman sonuç kümesinde yer alır. showDeleted ve showHidden değerlerinin False olarak ayarlanmasına izin verilmez.
İstemci durumu tutarlılığını sağlamak için minAccessRole sorgu parametresi nextSyncToken ile birlikte belirtilemez.
syncToken süresi dolarsa sunucu 410 GONE yanıt koduyla yanıt verir ve istemci, depolama alanını temizleyip syncToken olmadan tam senkronizasyon gerçekleştirir. 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 kapsamların en az biriyle yetkilendirme yapılması 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 metni

Bu yöntemle istek gövdesi sağlamayın.

Yanıt

Başarılı olursa bu yöntem, aşağıdaki yapıya sahip bir yanıt gövdesi 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'i.
nextPageToken string Bu sonucun 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 değişen girişleri almak için daha sonra kullanılan jeton. Daha fazla sonuç varsa atlanır. Bu durumda nextPageToken sağlanır.

Deneyin.

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