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.