Mevcut bir takvimi kullanıcının takvim listesine ekler. Hemen deneyin veya bir örneğe 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 dizine dayalı colorId alanı, otomatik olarak en iyi eşleme seçeneğine ayarlanır. İsteğe bağlı. Varsayılan, Yanlış değeridir.
|
Yetkilendirme
Bu istek, aşağıdaki kapsamla yetkilendirme gerektiriyor:
Kapsam |
---|
https://www.googleapis.com/auth/calendar |
Daha fazla bilgi 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 |
---|---|---|---|
Zorunlu mülkler | |||
id |
string |
Takvimin tanımlayıcısı. | |
İsteğe Bağlı Özellikler | |||
backgroundColor |
string |
Takvimin onaltılık biçimindeki "#0088aa " biçimindeki ana rengi. Bu özellik, dizine dayalı 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 |
Takvimin rengi. Bu kimlik, renk tanımının calendar bölümündeki bir girişi ifade eden bir kimliktir (renk 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 takvim için 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:
Hatırlatıcı eklerken zorunludur. |
yazılabilir |
defaultReminders[].minutes |
integer |
Etkinlik başlamadan kaç dakika önce hatırlatıcı tetikleneceğini belirtir. Geçerli değerler 0 ile 40.320 arasındadır (dakika cinsinden 4 hafta). Hatırlatıcı eklerken zorunludur. |
yazılabilir |
foregroundColor |
string |
"#ffffff " onaltılık biçiminde takvimin ön plan rengi. 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 |
notificationSettings |
object |
Kimliği doğrulanan 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:
Bildirim eklerken gerekir. |
yazılabilir |
notificationSettings.notifications[].type |
string |
Bildirimin türü. Olası değerler:
Bildirim eklerken gerekir. |
yazılabilir |
selected |
boolean |
Takvim içeriğinin takvim kullanıcı arayüzünde görünüp görünmeyeceğini belirler. İsteğe bağlı. Varsayılan, Yanlış değeridir. | 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ı kullanmalıdı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.
Aşağıdaki API Gezgini'ni kullanarak canlı verilerde bu yöntemi çağırın ve yanıtı görün.