CalendarList

Kullanıcının takvim listesindeki takvim koleksiyonu. Ayrıca Takvimler ve Takvim Listesibaşlıklı makaleyi de inceleyin.

Bu kaynağa yönelik yöntem listesi için bu sayfanın sonuna bakı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 etkin erişim rolü. Salt okunur. Olası değerler: "freeBusyReader" - Uygun/meşgul bilgilerine okuma erişimi sağlar. "reader" - Takvime okuma erişimi sağlar. Gizli etkinlikler, okuyucu erişimi olan kullanıcılara gösterilir ancak etkinlik ayrıntıları gizlenir. "writer" - Takvime okuma ve yazma erişimi sağlar. Gizli etkinlikler, yazma erişimi olan kullanıcılara gösterilir ve etkinlik ayrıntıları gösterilir. "owner" - Takvimin sahipliğini verir. Bu rol, yazar rolünün tüm izinlerine ek olarak EKL'leri görüntüleyip değiştirme yetkisinin yanı sıra vardır.
backgroundColor	string	Takvimin "#0088aa" onaltılı biçimindeki ana rengi. Bu özellik, dizine dayalı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için ekle, güncelleme ve yama yöntemlerinin parametrelerinde colorRgbFormat=true değerini belirtmeniz gerekir. İsteğe bağlı.	yazılabilir
colorId	string	Takvimin rengi. Bu, renk tanımının calendar bölümündeki bir girişi ifade eden bir kimliktir (renkler 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 takvim için konferans özellikleri (örneğin, izin verilen konferans türleri).
conferenceProperties.allowedConferenceSolutionTypes[]	list	Bu takvimde 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 takvimle ilgili 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'ı aracılığıyla gönderilir. Hatırlatıcı eklerken zorunludur.	yazılabilir
defaultReminders[].minutes	integer	Etkinlik başlamadan önce hatırlatıcının tetiklenmesi gereken dakika sayısı. Geçerli değerler 0 ile 40.320 (dakika cinsinden 4 hafta) arasındadır. 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 değer, Yanlış'tır.
description	string	Takvimin açıklaması. İsteğe bağlı. Salt okunur.
etag	etag	Kaynağın eTag'i.
foregroundColor	string	Takvimin "#ffffff" onaltılı biçimindeki ön plan rengi. Bu özellik, dizine dayalı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için ekle, güncelleme ve yama 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ı. Özellik yalnızca takvim gizlendiğinde döndürülür. Takvim gizlendiğinde değer true olur.	yazılabilir
id	string	Takvimin tanımlayıcısı.
kind	string	Kaynak 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ğrulanmış 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 gereklidir.	yazılabilir
notificationSettings.notifications[].type	string	Bildirimin türü. Olası değerler: "eventCreation" - Takvime yeni bir etkinlik eklendiğinde bildirim gönderilir. "eventChange" - Bir etkinlik değiştirildiğinde bildirim gönderilir. "eventCancellation" - Bir etkinlik iptal edildiğinde bildirim gönderilir. "eventResponse" - Bir katılımcı etkinlik davetiyesine yanıt verdiğinde bildirim gönderilir. "agenda" - Günün olaylarını içeren bir gündem (sabah gönderilir). Bildirim eklerken gereklidir.	yazılabilir
primary	boolean	Takvimin, kimliği doğrulanmış kullanıcının birincil takvimi olup olmadığı. Salt okunur. İsteğe bağlı. Varsayılan değer, Yanlış'tır.
selected	boolean	Takvim içeriğinin takvim kullanıcı arayüzünde gösterilip gösterilmeyeceği. İsteğe bağlı. Varsayılan değer, Yanlış'tır.	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

Bir takvimi, kullanıcının takvim listesinden kaldırır.

al

Kullanıcının takvim listesinden bir takvim döndürür.

ekle

Mevcut bir takvimi kullanıcının takvim listesine 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 anlamını destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın; get ve ardından update kullanmayı tercih edersiniz. Belirttiğiniz alan değerleri, mevcut değerlerin yerine geçer. İstekte belirtmediğiniz alanlar değiştirilmeden kalır. Dizi alanları, belirtilirse mevcut dizilerin üzerine yazılır; bu işlem, önceki dizi öğelerini siler.

güncelle

Kullanıcının takvim listesindeki mevcut bir takvimi günceller.

saat

CalendarList kaynaklarında yapılan değişiklikleri takip edin.