CalendarList: insert

Mevcut bir takvimi kullanıcının takvim listesine ekler. Hemen deneyin veya örneke göz atın.

İ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, onaltı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 mülkün yerini backgroundColor ve foregroundColor mülkleri almıştır ve bu mülkler kullanılırken göz ardı edilebilir. İ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çiminde değeri. 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 gizlenmiş olup olmadığı. İ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.

Ö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();

// Create a new calendar list entry
CalendarListEntry calendarListEntry = new CalendarListEntry();
calendarListEntry.setId("calendarId");

// Insert the new calendar list entry
CalendarListEntry createdCalendarListEntry = service.calendarList().insert(calendarListEntry).execute();

System.out.println(createdCalendarListEntry.getSummary());

Python

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

calendar_list_entry = {
    'id': 'calendarId'
}

created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute()

print created_calendar_list_entry['summary']

PHP

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

$calendarListEntry = new Google_Service_Calendar_CalendarListEntry();
$calendarListEntry->setId("calendarId");

$createdCalendarListEntry = $service->calendarList->insert($calendarListEntry);

echo $createdCalendarListEntry->getSummary();

Ruby

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

entry = Google::Apis::CalendarV3::CalendarListEntry.new(
 id: 'calendarId'
)

result = client.insert_calendar_list(entry)
print result.summary

Deneyin!

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