Events: instances

Belirtilen düzenli etkinliğin örneklerini döndürür. Şimdi deneyin.

İstek

HTTP isteği

GET https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId/instances

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
calendarId string Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini çağırın. Şu anda oturum açmış kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.
eventId string Düzenli etkinlik tanımlayıcısı.
İsteğe bağlı sorgu parametreleri
alwaysIncludeEmail boolean Kullanımdan kaldırıldı ve yoksayıldı. Gerçek bir e-posta adresi olmasa bile (ör. oluşturulmuş, çalışmayan bir değer sağlanır) düzenleyen, oluşturucu ve katılımcılar için email alanında her zaman bir değer döndürülür.
maxAttendees integer Yanıtın dahil edilecek maksimum katılımcı sayısı. Belirtilen sayıda katılımcıdan fazla varsa yalnızca katılımcı döndürülür. İsteğe bağlıdır.
maxResults integer Bir sonuç sayfasında döndürülen maksimum etkinlik sayısı. Varsayılan olarak bu değer 250 etkinliktir. Sayfa boyutu hiçbir zaman 2.500 etkinlikten büyük olamaz. İsteğe bağlıdır.
originalStart string Sonuçtaki örneğin orijinal başlangıç zamanı. İsteğe bağlıdır.
pageToken string Hangi sonuç sayfasının döndürüleceğini belirten jeton. İsteğe bağlıdır.
showDeleted boolean Silinen etkinliklerin (status değeri "cancelled" olan) sonuca dahil edilip edilmeyeceği. Düzenli etkinliklerin iptal edilen örnekleri, singleEvents False ise yine de dahil edilir. İsteğe bağlıdır. Varsayılan değer False'tur.
timeMax datetime Filtrelemek için etkinliğin başlangıç zamanının üst sınırı (hariç). İsteğe bağlıdır. Varsayılan olarak başlangıç zamanına göre filtreleme yapılmaz. Zorunlu saat dilimi farkı içeren bir RFC3339 zaman damgası olmalıdır.
timeMin datetime Filtreleme için etkinliğin bitiş zamanının alt sınırı (dahil). İsteğe bağlıdır. Varsayılan olarak bitiş zamanına göre filtreleme yapılmaz. Zorunlu saat dilimi farkı içeren bir RFC3339 zaman damgası olmalıdır.
timeZone string Yanıtta kullanılan saat dilimi. İsteğe bağlıdır. Varsayılan olarak takvimin saat dilimi kullanılır.

Yetkilendirme

Bu istek, aşağıdaki kapsamların en az biriyle yetkilendirmeye olanak tanır:

Kapsam
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.readonly
https://www.googleapis.com/auth/calendar.events
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.events.owned
https://www.googleapis.com/auth/calendar.events.owned.readonly
https://www.googleapis.com/auth/calendar.events.public.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 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#events",
  "etag": etag,
  "summary": string,
  "description": string,
  "updated": datetime,
  "timeZone": string,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "items": [
    events Resource
  ]
}
Mülk adı Değer Açıklama Notlar
kind string Koleksiyonun türü ("calendar#events").
etag etag Koleksiyonun ETag'i.
summary string Takvimin başlığı. Salt okunur.
description string Takvimin açıklaması. Salt okunur.
updated datetime Takvimin son değiştirilme zamanı (RFC3339 zaman damgası olarak). Salt okunur.
timeZone string Takvimin saat dilimi Salt okunur.
accessRole string Kullanıcının bu takvimdeki erişim rolü. Salt okunur. Olası değerler:
  • "none": Kullanıcının erişimi yok.
  • "freeBusyReader": Kullanıcı, uygun/meşgul bilgilerine okuma erişimine sahiptir.
  • "reader": Kullanıcının takvime okuma erişimi vardır. Gizli etkinlikler, okuyucu erişimi olan kullanıcılara gösterilir ancak etkinlik ayrıntıları gizlenir.
  • "writer": Kullanıcı, takvime okuma ve yazma erişimine sahiptir. Yazma erişimi olan kullanıcılar, gizli etkinlikleri ve etkinlik ayrıntılarını görebilir.
  • "owner": Kullanıcı, takvime yönetici erişimine sahiptir. Bu rol, yazar rolünün tüm izinlerine ek olarak diğer kullanıcıların erişim düzeylerini görme ve değiştirme özelliğine sahiptir.

defaultReminders[] list Kimliği doğrulanmış kullanıcının takvimindeki varsayılan hatırlatıcılar. Bu hatırlatıcılar, bu takvimdeki açıkça geçersiz kılınmayan (ör. reminders.useDefault değeri "Doğru" olarak ayarlanmamış) tüm etkinlikler için geçerlidir.
defaultReminders[].method string Bu hatırlatıcı tarafından kullanılan yöntem. Olası değerler:
  • "email": Hatırlatmalar e-postayla gönderilir.
  • "popup": Hatırlatmalar, kullanıcı arayüzünde pop-up olarak gönderilir.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
defaultReminders[].minutes integer Hatırlatıcının tetiklenmesi gereken, etkinliğin başlangıcından önceki dakika sayısı. Geçerli değerler 0 ile 40320 (4 hafta dakika cinsinden) arasındadır.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
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 Takvimdeki etkinliklerin listesi.
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.