CalendarList

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

Bu kaynakla ilgili yöntemlerin 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ğrulanmış 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. Özel 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. Özel etkinlikler, yazar erişimi olan kullanıcılara görünür ve etkinlik ayrıntıları görünür durumda olur.
  • "owner": Takvimin sahipliğini sağlar. Bu rol, EKL'leri görme ve değiştirmeyle ilgili ek işlevin yanı sıra yazar rolünün tüm izinlerine sahiptir.
backgroundColor string Takvimin "#0088aa" onaltılık biçimindeki ana rengi. Bu özellik, dizin tabanlı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için insert, update ve yama yöntemlerinin parametrelerinde colorRgbFormat=true öğesini 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şe referans veren bir kimliktir (renk uç noktasına bakın). Bu özelliğin yerini backgroundColor ve foregroundColor özellikleri alır. Bu özellikler kullanılırken yoksayılabilir. İsteğe bağlı. yazılabilir
conferenceProperties nested object Bu takvim için konferans özellikleri (ör. izin verilen konferans türleri).
conferenceProperties.allowedConferenceSolutionTypes[] list Bu takvimde desteklenen konferans çözümü türleri.

Olası değerler:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
İsteğe bağlı.

defaultReminders[] list Kimliği doğrulanmış 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ı tarafından kullanılan 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'ı üzerinden gönderilir.

Hatırlatıcı eklerken zorunludur.

yazılabilir
defaultReminders[].minutes integer Etkinlik başlamadan önceki, hatırlatıcının tetiklenmesi gereken dakika sayısı. Geçerli değerler 0 ile 40320 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ı. False, varsayılan değerdir.
description string Takvimin açıklaması. İsteğe bağlı. Salt okunur.
etag etag Kaynağın eTag'i.
foregroundColor string On altılı biçimdeki "#ffffff" biçimindeki 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 yama yöntemlerinin parametrelerinde colorRgbFormat=true öğesini 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 Takvim tanımlayıcısı.
kind string Kaynağın türü ("calendar#calendarListEntry").
location string Takvimin serbest biçimli metin olarak bulunduğu 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 Bildirimi göndermek 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 gönderilen bildirim.
  • "eventChange" - Bir etkinlik değiştirildiğinde gönderilen bildirim.
  • "eventCancellation": Bir etkinlik iptal edildiğinde gönderilen bildirim.
  • "eventResponse" - Bir katılımcı etkinlik davetiyesine yanıt verdiğinde gönderilen bildirim.
  • "agenda": Gün içindeki etkinlikleri (sabahları gönderilir) içeren bir gündemdir.

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ı. False, varsayılan değerdir.
selected boolean Takvim içeriğinin takvim kullanıcı arayüzünde görünüp görünmediği. İsteğe bağlı. False, varsayılan değerdir. yazılabilir
summary string Takvimin başlığı. Salt okunur.
summaryOverride string Kimliği doğrulanmış 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.
edin
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 semantiğini destekler. Her yama isteğinin üç kota birimi tükettiğini unutmayın. get ve ardından update kullanın. Belirttiğiniz alan değerleri mevcut değerlerin yerini alır. İstekte belirtmediğiniz alanlar değişmez. Dizi alanları, belirtilirse mevcut dizilerin üzerine yazılır. Bu, önceki dizi öğelerini siler.
güncelle
Kullanıcının takvim listesindeki mevcut bir takvimi günceller.
izleyin
CalendarList kaynaklarında yapılan değişiklikleri izleyin.