Calendars

Mevcut tüm takvimlerin koleksiyonu. Calendars ve CalendarList karşılaştırması başlıklı makaleyi de inceleyin.

Bu kaynağın yöntemlerinin listesini bu sayfanın sonunda bulabilirsiniz.

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,
  "workingHours": {
    "workingHoursEnabled": boolean,
    "availableTimes": [
      {
        "dayOfWeek": string,
        "periodStart": integer,
        "periodEnd": integer
      }
    ]
  }
}
Mülk adı Değer Açıklama Notlar
autoAcceptInvitations boolean Bu takvimin davetiyeleri otomatik olarak kabul edip etmediği. Yalnızca kaynak takvimleri için geçerlidir.
conferenceProperties nested object Bu takvimin konferans özellikleri (ör. izin verilen konferans türleri).
conferenceProperties.allowedConferenceSolutionTypes[] list Bu takvim için desteklenen konferans çözümü türleri.

Olası değerler şunlardır:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
İsteğe bağlı.
dataOwner string Takvim 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 yazılır. Belirtilmezse etiket özellikleri değişmeden kalır. yazılabilir
labelProperties.eventLabels[] list Bu takvimde tanımlanan etkinlik etiketleri. Takvim güncellenirken bu mevcutsa mevcut etkinlik etiketlerinin yerini alır.

Yeni bir etkinlik etiketi eklemek için listeyi genişletin ve takvimden bir etiketi silmek için listeden varlıkları kaldırın.

Her takvimde en fazla 200 etiket bulunabilir.

 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. Sağlanmazsa benzersiz bir kimlik oluşturulur. Bir etiket güncellenirken gereklidir.

Sağlanmışsa 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ı.

Sağlanıyorsa en fazla 50 karakter içermelidir.

 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çimlendirilmiş, ör. "Europe/Zurich".) İsteğe bağlı. yazılabilir
workingHours object Kullanıcının çalışma saatleriyle ilgili bilgileri temsil eder. Yalnızca Google Workspace kullanıcılarının birincil takvimlerinde kullanılabilir. Çalışma saatlerini güncellemek için çalışma saatleri nesnesinin tamamı iletilmelidir. Belirtilmezse (veya boş ya da boş bir nesne olarak iletilirse) mevcut çalışma saatleri değişmez. Çalışma saatlerini devre dışı bırakmak veya programı temizlemek için workingHoursEnabled değerini false olarak ayarlayın (ve availableTimes değerini atlayın veya boş bir liste iletin). yazılabilir
workingHours.availableTimes[] list Çalışma saatleri. Her müsaitlik dönemi, kullanıcının bir gün içindeki çalışma saatleri blokunu temsil eder. yazılabilir
workingHours.availableTimes[].dayOfWeek string Haftanın günleri. Zorunlu. Olası değerler:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
yazılabilir
workingHours.availableTimes[].periodEnd integer Dönem sonu, günün başlangıcından itibaren dakika cinsinden, hariç. Zorunlu. yazılabilir
workingHours.availableTimes[].periodStart integer Dönem başlangıcı, günün başlangıcından itibaren dakika cinsinden (dahil). Zorunlu. yazılabilir
workingHours.workingHoursEnabled boolean Bu takvim için çalışma saatlerinin etkinleştirilip etkinleştirilmediği. availableTimes boş olduğunda "true" olarak ayarlanamaz. 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
İkincil takvim oluşturur.

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

patch
Bir takvimin meta verilerini 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 kullanmayı tercih edin. Belirttiğiniz alan değerleri, mevcut değerlerin yerini alır. İstekte belirtmediğiniz alanlar değişmeden kalır. Dizi alanları belirtilirse mevcut dizilerin üzerine yazılır. Bu işlem, önceki dizi öğelerini siler.
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ılan veya silinen takvimlerin aktarılması desteklenmez.
güncelleme
Bir takvimin meta verilerini günceller.