CalendarList: insert

Mevcut bir takvimi kullanıcının takvim listesine ekler. Şimdi deneyin.

İstek

HTTP isteği

POST https://www.googleapis.com/calendar/v3/users/me/calendarList

Parametreler

Parametre adı Değer Açıklama
İsteğe bağlı sorgu parametreleri
colorRgbFormat boolean Takvim renklerini (RGB) yazmak için foregroundColor ve backgroundColor alanlarının kullanılıp kullanılmayacağı. Bu özellik kullanılırsa dizin tabanlı colorId alanı otomatik olarak en iyi eşleşen seçeneğe ayarlanır. İsteğe bağlı. Varsayılan değer False'tır.

Yetkilendirme

Bu istek için aşağıdaki kapsamlardan en az biri ile yetkilendirme gerekir:

Kapsam
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.calendarlist

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

İstek içeriği

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

Mülk adı Değer Açıklama Notlar
Zorunlu Özellikler
id string Takvim kimliği.
İsteğe bağlı özellikler
backgroundColor string Takvim ana rengi, on altılı "#0088aa" biçiminde. Bu özellik, dizin tabanlı 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ı. yazılabilir
colorId string Takvim rengini belirtir. Bu, colors tanımının calendar bölümündeki bir girişi belirten bir kimliktir (colors uç noktasına bakın). Bu özelliğin yerini backgroundColor ve foregroundColor özellikleri almıştır. Bu özellikler kullanılırken bu özellik yoksayılabilir. İsteğe bağlı. yazılabilir
defaultReminders[] list Kimliği doğrulanmış kullanıcının bu takvim için 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ırlatmalar e-postayla gönderilir.
  • "popup": Hatırlatıcılar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
defaultReminders[].minutes integer Hatırlatıcının etkinlikten kaç dakika önce tetiklenmesi gerektiğini belirtir. Geçerli değerler 0 ile 40.320 (dakikada 4 hafta) arasındadır.

Hatırlatıcı eklerken gereklidir.

 yazılabilir
foregroundColor string Takvim ön plan renginin onaltılı "#ffffff" biçimi. Bu özellik, dizin tabanlı 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ı. yazılabilir
hidden boolean Takvim listesinden gizlendiyse. İsteğe bağlı. Özellik yalnızca takvim gizliyken döndürülür. Bu durumda değer true olur. yazılabilir
notificationSettings object Kimliği doğrulanmış kullanıcının bu takvim için aldığı bildirimler. yazılabilir
notificationSettings.notifications[].method string Bildirimi göndermek için kullanılan yöntem. Olası değer:
  • "email": Bildirimler e-postayla gönderilir.

Bildirim eklenirken gereklidir.

 yazılabilir
notificationSettings.notifications[].type string Bildirim 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 eklenirken gereklidir.

 yazılabilir
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 False'tır. yazılabilir
summaryOverride string Kimliği doğrulanmış kullanıcının bu takvim için belirlediği özet. İsteğe bağlı. yazılabilir

Yanıt

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

Deneyin!

Canlı verilerde bu yöntemi çağırmak ve yanıtı görmek için aşağıdaki API Gezgini'ni kullanın.