Calendars: update

Bir takvimin meta verilerini günceller. Şimdi deneyin.

İstek

HTTP isteği

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Parametreler

Parametre adı Değer Açıklama
Yol parametreleri
calendarId string Takvim tanımlayıcısı. Takvim kimliklerini almak için calendarList.list yöntemini çağırın. O anda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" anahtar kelimesini kullanın.

Yetkilendirme

Bu istek, aşağıdaki kapsamlardan en az biriyle yetkilendirme gerektirir:

Kapsam
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

Daha fazla bilgi için kimlik doğrulama ve yetkilendirme sayfasını inceleyin.

İstek metni

İstek gövdesinde, aşağıdaki özelliklere sahip bir Calendars kaynağı sağlayın:

Mülk adı Değer Açıklama Notlar
İsteğe bağlı özellikler
description string Takvimin açıklaması. İsteğe bağlı. yazılabilir
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

Yanıt

Başarılı olursa bu yöntem, yanıt gövdesinde bir Calendars kaynağı döndürür.

Deneyin.

Bu yöntemi canlı veriler üzerinde çağırıp yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.