CalendarList

Kullanıcının takvim listesindeki takvimlerin koleksiyonu. Takvimler ve Takvim Listesi. başlıklı makaleyi de inceleyin.

Bu kaynağa ilişkin yöntemlerin listesi için bu sayfanın sonuna göz atın.

Kaynak temsilleri

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}
Mülk adı Değer Açıklama Notlar
accessRole string Kimliği doğrulanan kullanıcının takvimde sahip olduğu etkili erişim rolü. Salt okunur. Olası değerler:
  • "freeBusyReader": Uygun/meşgul bilgilerine okuma erişimi sağlar.
  • "reader" - Takvim için okuma erişimi sağlar. Gizli etkinlikler, okuyucu erişimi olan kullanıcılara gösterilir ancak etkinlik ayrıntıları gizlenir.
  • "writer" - Takvim için okuma ve yazma erişimi sağlar. Gizli etkinlikler, yazar erişimi olan kullanıcılara gösterilir. Etkinlik ayrıntıları ise görünür olur.
  • "owner": Takvimin sahipliğini sağlar. Bu rol, yazar rolünün tüm izinlerine sahiptir. Ek olarak, EKL'leri görebilir ve değiştirebilir.
backgroundColor string Takvimin onaltılık biçimindeki "#0088aa" biçimindeki ana rengi. Bu özellik, dizine dayalı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için insert, update ve patch yöntemlerinin parametrelerinde colorRgbFormat=true değerini belirtmeniz gerekir. İsteğe bağlı. yazılabilir
colorId string Takvimin rengi. Bu kimlik, renk tanımının calendar bölümündeki bir girişi ifade eden bir kimliktir (renk uç noktasına bakın). Bu özelliğin yerini backgroundColor ve foregroundColor özellikleri alır ve bu özellikler kullanılırken yoksayılabilir. İsteğe bağlı. yazılabilir
conferenceProperties nested object Bu takvimle ilgili konferans özellikleri (ör. izin verilen konferans türleri).
conferenceProperties.allowedConferenceSolutionTypes[] list Bu takvim için desteklenen konferans çözümlerinin türleri.

Olası değerler şunlardır:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
İsteğe bağlıdır.
defaultReminders[] list Kimliği doğrulanan kullanıcının bu takvim için sahip olduğu varsayılan hatırlatıcılar. yazılabilir
defaultReminders[].method string Bu hatırlatıcının kullandığı yöntem. Olası değerler:
  • "email" - Hatırlatıcılar e-postayla gönderilir.
  • "popup" - Hatırlatıcılar, kullanıcı arayüzü pop-up'ı yoluyla gönderilir.

Hatırlatıcı eklerken zorunludur.

 yazılabilir
defaultReminders[].minutes integer Etkinlik başlamadan kaç dakika önce hatırlatıcı tetikleneceğini belirtir. Geçerli değerler 0 ile 40.320 arasındadır (dakika cinsinden 4 hafta).

Hatırlatıcı eklerken zorunludur.

 yazılabilir
deleted boolean Bu takvim listesi girişinin takvim listesinden silinip silinmediği. Salt okunur. İsteğe bağlı. Varsayılan, Yanlış değeridir.
description string Takvimin açıklaması. İsteğe bağlı. Salt okunur.
etag etag Kaynağın ETag.
foregroundColor string "#ffffff" onaltılık biçiminde takvimin ön plan rengi. Bu özellik, dizin tabanlı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için insert, update ve patch yöntemlerinin parametrelerinde colorRgbFormat=true değerini belirtmeniz gerekir. İsteğe bağlı. yazılabilir
hidden boolean Takvimin listede gizlenip gizlenmediği. İsteğe bağlı. Bu özellik yalnızca takvim gizlendiğinde döndürülür. Bu durumda değer true olur. yazılabilir
id string Takvimin tanımlayıcısı.
kind string Kaynağın türü ("calendar#calendarListEntry").
location string Serbest biçimli metin olarak takvimin coğrafi konumu. İsteğe bağlı. Salt okunur.
notificationSettings object Kimliği doğrulanan kullanıcının bu takvim için aldığı bildirimler. yazılabilir
notificationSettings.notifications[] list Bu takvim için ayarlanan bildirimlerin listesi.
notificationSettings.notifications[].method string Bildirimin gönderilmesi için kullanılan yöntem. Olası değer:
  • "email" - Bildirimler e-postayla gönderilir.

Bildirim eklerken gerekir.

 yazılabilir
notificationSettings.notifications[].type string Bildirimin türü. Olası değerler:
  • "eventCreation": Takvime yeni bir etkinlik eklendiğinde gönderilen bildirim.
  • "eventChange": Etkinlik değiştirildiğinde bildirim gönderilir.
  • "eventCancellation" - Etkinlik iptal edildiğinde gönderilen bildirim.
  • "eventResponse": Bir katılımcı etkinlik davetiyesine yanıt verdiğinde bildirim gönderilir.
  • "agenda" - Günün etkinliklerini içeren ajanda (sabahları gönderilir).

Bildirim eklerken gerekir.

 yazılabilir
primary boolean Takvimin, kimliği doğrulanan kullanıcının birincil takvimi olup olmadığı. Salt okunur. İsteğe bağlı. Varsayılan, Yanlış değeridir.
selected boolean Takvim içeriğinin takvim kullanıcı arayüzünde görünüp görünmeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış değeridir. yazılabilir
summary string Takvimin başlığı. Salt okunur.
summaryOverride string Kimliği doğrulanan kullanıcının bu takvim için ayarladığı özet. İsteğe bağlı. yazılabilir
timeZone string Takvimin saat dilimi. İsteğe bağlı. Salt okunur.

Yöntemler

sil
Kullanıcının takvim listesinden bir takvimi kaldırır.
al
Kullanıcının takvim listesinden bir takvim döndürür.
ekle
Kullanıcının takvim listesine mevcut bir takvimi ekler.
list
Kullanıcının takvim listesindeki takvimleri döndürür.
yama
Kullanıcının takvim listesindeki mevcut bir takvimi günceller. Bu yöntem yama semantiğini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; get ve ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri mevcut değerlerin yerine geçer. İstekte belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse, mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler.
güncelleme
Kullanıcının takvim listesindeki mevcut bir takvimi günceller.
saat
CalendarList kaynaklarında yapılan değişiklikleri takip edin.