CalendarList: update

Kullanıcının takvim listesindeki mevcut bir takvimi günceller. Şimdi deneyin veya bir örneğe göz atın.

İstek

HTTP isteği

PUT https://www.googleapis.com/calendar/v3/users/me/calendarList/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 kullanın. Şu anda giriş yapmış olan kullanıcının birincil takvimine erişmek istiyorsanız "primary" bağlantısını kullanın. anahtar kelime.
İ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 dizine dayalı colorId alanı, en iyi eşleşen seçeneğe otomatik olarak ayarlanır. İsteğe bağlı. Varsayılan değer, Yanlış'tır.

Yetkilendirme

Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:

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

Daha fazla bilgi edinmek için kimlik doğrulama ve yetkilendirme sayfasına göz atı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
İsteğe Bağlı Özellikler
backgroundColor string Takvimin "#0088aa" onaltılı biçimindeki ana rengi. Bu özellik, dizine dayalı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için ekle, güncelleme ve yama yöntemlerinin parametrelerinde colorRgbFormat=true değerini belirtmeniz gerekir. İsteğe bağlı. yazılabilir
colorId string Takvimin rengi. Bu, renk tanımının calendar bölümündeki bir girişi ifade eden bir kimliktir (renkler uç noktasına bakın). Bu özelliğin yerini backgroundColor ve foregroundColor özellikleri alır ve bu özellikler kullanılırken yoksayılabilir. İsteğe bağlı. yazılabilir
defaultReminders[] list Kimliği doğrulanan kullanıcının bu takvimle ilgili sahip olduğu 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ırlatıcılar e-postayla gönderilir.
  • "popup" - Hatırlatıcılar, kullanıcı arayüzü pop-up'ı aracılığıyla gönderilir.

Hatırlatıcı eklerken zorunludur.

 yazılabilir
defaultReminders[].minutes integer Etkinlik başlamadan önce hatırlatıcının tetiklenmesi gereken dakika sayısı. Geçerli değerler 0 ile 40.320 (dakika cinsinden 4 hafta) arasındadır.

Hatırlatıcı eklerken zorunludur.

 yazılabilir
foregroundColor string Takvimin "#ffffff" onaltılı biçimindeki ön plan rengi. Bu özellik, dizine dayalı colorId özelliğinin yerini alır. Bu özelliği ayarlamak veya değiştirmek için ekle, güncelleme ve yama yöntemlerinin parametrelerinde colorRgbFormat=true değerini belirtmeniz gerekir. İsteğe bağlı. yazılabilir
hidden boolean Takvimin listede gizlenip gizlenmediği. İsteğe bağlı. Özellik yalnızca takvim gizlendiğinde döndürülür. Takvim gizlendiğinde 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 Bildirimin gönderilmesi 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 bildirim gönderilir.
  • "eventChange" - Bir etkinlik değiştirildiğinde bildirim gönderilir.
  • "eventCancellation" - Bir etkinlik iptal edildiğinde bildirim gönderilir.
  • "eventResponse" - Bir katılımcı etkinlik davetiyesine yanıt verdiğinde bildirim gönderilir.
  • "agenda" - Günün olaylarını içeren bir gündem (sabah gönderilir).

Bildirim eklerken 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, Yanlış'tır. yazılabilir
summaryOverride string Kimliği doğrulanan kullanıcının bu takvim için ayarladığı ö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.

Örnekler

Not: Bu yöntem için kullanıma sunulan kod örnekleri, desteklenen tüm programlama dillerini kapsamaz (Desteklenen dillerin listesi için istemci kitaplıkları sayfasını inceleyin).

Java

Java istemci kitaplığını kullanır.

import com.google.api.services.calendar.Calendar;
import com.google.api.services.calendar.model.CalendarListEntry;

// ...

// Initialize Calendar service with valid OAuth credentials
Calendar service = new Calendar.Builder(httpTransport, jsonFactory, credentials)
    .setApplicationName("applicationName").build();

// Retrieve the calendar list entry
CalendarListEntry calendarListEntry = service.calendarList().get("calendarId").execute();

// Make a change
calendarListEntry.setColorId("newColorId");

// Update the altered entry
CalendarListEntry updatedCalendarListEntry =
    service.calendarList().update(calendarListEntry.getId(), calendarListEntry).execute();

System.out.println(updatedCalendarListEntry.getEtag());

Python

Python istemci kitaplığını kullanır.

# First retrieve the calendarListEntry from the API.
calendar_list_entry = service.calendarList().get(calendarId='calendarId').execute()
calendar_list_entry['colorId'] = 'newColorId'

updated_calendar_list_entry = service.calendarList().update(
    calendarId=calendar_list_entry['id'], body=calendar_list_entry).execute()

print created_calendar_list_entry['etag']

PHP

PHP istemci kitaplığını kullanır.

// First retrieve the calendarListEntry from the API.
$calendarListEntry = $service->calendarList->get('calendarId');
$calendarListEntry->setColorId('newColorId');

$updatedCalendarListEntry = service->calendarList->update($calendarListEntry->getId(), $calendarListEntry);

echo $updatedCalendarListEntry->getEtag();

Ruby

Ruby istemci kitaplığını kullanır.

calendar_list_entry = client.get_calendar_list('calendarId')
calendar_list_entry.colorId = 'newColorId'
result = client.update_calendar_list(calendar_list_entry.id, calendar_list_entry)
print result.etag

Deneyin!

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