CalendarList

Kullanıcının takvim listesindeki takvim koleksiyonu. Ayrıca Calendars ve CalendarListbaşlıklı makaleyi 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,
  "dataOwner": 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": Boş/meşgul bilgisine 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. Yazma erişimi olan kullanıcılar, gizli etkinlikleri ve etkinlik ayrıntılarını görebilir.
  • "owner": Yöneticinin takvime erişmesini sağlar. 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.

backgroundColor string Takvimin onaltılık biçimdeki ana rengi "#0088aa". 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ıdır. yazılabilir
colorId string Takvimin rengi. Bu, renk tanımının calendar bölümündeki bir girişi ifade eden kimliktir (bkz. colors uç noktası). Bu özelliğin yerini backgroundColor ve foregroundColor özellikleri almıştır. Bu özellikleri kullanırken bu özellik yoksayılabilir. İsteğe bağlıdır. yazılabilir
conferenceProperties nested object Bu takvim için konferans özellikleri (ör. hangi tür konferanslara izin verildiği).
conferenceProperties.allowedConferenceSolutionTypes[] list Bu takvim için desteklenen konferans çözümleri türleri.

Olası değerler:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
İsteğe bağlıdır.
dataOwner string Takvimin sahibinin e-posta adresi. Yalnızca ikincil takvimler için ayarlanır. Salt okunur.
defaultReminders[] list Kimliği doğrulanmış kullanıcının bu takvim için ayarladığı 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ı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
deleted boolean Bu takvim listesi girişinin takvim listesinden silinip silinmediği. Salt okunur. İsteğe bağlıdır. Varsayılan değer False'tur.
description string Takvimin açıklaması. İsteğe bağlıdır. Salt okunur.
etag etag Kaynağın ETag'i.
foregroundColor string Takvimin onaltılı biçimdeki "#ffffff" ön plan 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ıdır. yazılabilir
hidden boolean Takvimin listeden gizlenip gizlenmediği. İsteğe bağlıdır. 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 Takvimin coğrafi konumu serbest biçimli metin olarak. İsteğe bağlıdır. 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 davetine yanıt verdiğinde gönderilen bildirim.
  • "agenda": Günün etkinliklerini 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ıdır. Varsayılan değer False'tur.
selected boolean Takvim içeriğinin takvim kullanıcı arayüzünde gösterilip gösterilmediği. İsteğe bağlıdır. Varsayılan değer False'tur. 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ıdır. yazılabilir
timeZone string Takvimin saat dilimi İsteğe bağlıdır. Salt okunur.

Yöntemler

sil
Kullanıcının takvim listesinden bir takvimi kaldırır.
get
Kullanıcının takvim listesinden bir takvim döndürür.
insert
Mevcut bir takvimi kullanıcının takvim listesine ekler.
list
Kullanıcının takvim listesindeki takvimleri döndürür.
patch
Kullanıcının takvim listesindeki mevcut bir takvimi günceller. Bu yöntem, yama semantiğini destekler. Her yama isteğinin üç kota birimi kullandığını unutmayın. get ardından update kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstek içinde belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
güncelleme
Kullanıcının takvim listesindeki mevcut bir takvimi günceller.
watch
CalendarList kaynaklarındaki değişiklikleri izleyin.