Calendars

Mevcut tüm takvimlerin bir koleksiyonu. Ayrıca Calendars ve CalendarList başlıklı makaleyi inceleyin.

Bu kaynakla ilgili yöntemlerin listesi için bu sayfanın sonuna bakın.

Kaynak temsilleri

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "labelProperties": {
    "eventLabels": [
      {
        "id": string,
        "backgroundColor": string,
        "name": string
      }
    ]
  },
  "autoAcceptInvitations": boolean
}
Mülk adı Değer Açıklama Notlar
autoAcceptInvitations boolean Bu takvimin davetiyeleri otomatik olarak kabul edip etmeyeceği. Yalnızca kaynak takvimleri için geçerlidir.
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.
description string Takvimin açıklaması. İsteğe bağlı. yazılabilir
etag etag Kaynağın ETag'i.
id string Takvimin tanımlayıcısı. Kimlikleri almak için calendarList.list() yöntemini çağırın.
kind string Kaynağın türü ("calendar#calendar").
labelProperties nested object Bu takvimde tanımlanan etiket özellikleri. Belirtilirse mevcut etiket özelliklerinin üzerine yazar. Belirtilmezse etiket özellikleri değişmeden kalır. yazılabilir
labelProperties.eventLabels[] list Bu takvimde tanımlanan etkinlik etiketleri. Takvim güncellenirken bu etiket varsa mevcut etkinlik etiketlerinin yerini alır.

Yeni bir etkinlik etiketi eklemek için listeyi genişletin ve takvimden bir etiketi silmek için listedeki öğeleri kaldırın.

Her takvimde en fazla 200 etiket olabilir.

 yazılabilir
labelProperties.eventLabels[].backgroundColor string Etiketin onaltılık biçimdeki arka plan rengi (ör. "#039be5"). Bu etikete sahip etkinlikler bu renkte gösterilir. Zorunlu. yazılabilir
labelProperties.eventLabels[].id string Etiketin kimliği. Yeni bir etiket eklerken isteğe bağlıdır. Belirtilmezse benzersiz bir kimlik oluşturulur. Etiket güncellenirken gereklidir.

Sağlanırsa kimlik, takvim içinde benzersiz olmalı ve UUID biçiminde olmalıdır.

 yazılabilir
labelProperties.eventLabels[].name string Etiketin adı. İsteğe bağlı.

Bu değer sağlanırsa en fazla 50 karakter olmalıdır.

 yazılabilir
location string Takvimin coğrafi konumu serbest biçimli metin olarak. İsteğe bağlı. yazılabilir
summary string Takvimin başlığı. yazılabilir
timeZone string Takvimin saat dilimi (IANA Saat Dilimi Veritabanı adı olarak biçimlendirilir, ör. "Europe/Zurich".) İsteğe bağlı. yazılabilir

Yöntemler

temizle
Birincil takvimi temizler. Bu işlem, bir hesabın birincil takvimiyle ilişkili tüm etkinlikleri siler.
delete
İkincil bir takvimi siler. Birincil takvimlerdeki tüm etkinlikleri temizlemek için calendars.clear yöntemini kullanın.
get
Bir takvimin meta verilerini döndürür.
insert (ekle)
İkincil bir takvim oluşturur.

İstek için kimliği doğrulanmış kullanıcı, yeni takvimin veri sahibi yapılır.

patch
Bir takvimin meta verilerini 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. Belirtilmişse dizi alanları mevcut dizilerin üzerine yazılır. Bu durumda, önceki dizi öğeleri silinir.
transferOwnership
Google Workspace kuruluşundaki kullanıcılar arasında ikincil takvim aktarır. Takvimleri yönetme yönetici ayrıcalığıyla kullanıcı kimlik doğrulaması ve aşağıdaki yetkilendirme kapsamlarından biri gerekir:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
İstekte useAdminAccess değerini true olarak ayarlayın. İkincil takvimin aktarılabilmesi için etkin olması gerekir. Devre dışı bırakılmış veya silinmiş takvimlerin aktarılması desteklenmez.
update
Bir takvimin meta verilerini günceller.