Menyisipkan kalender yang sudah ada ke dalam daftar kalender pengguna. Coba sekarang atau lihat contohnya.
Permintaan
Permintaan HTTP
POST https://www.googleapis.com/calendar/v3/users/me/calendarList
Parameter
Nama parameter | Nilai | Deskripsi |
---|---|---|
Parameter kueri opsional | ||
colorRgbFormat |
boolean |
Menentukan apakah akan menggunakan kolom foregroundColor dan backgroundColor untuk menulis warna kalender (RGB). Jika fitur ini digunakan, kolom colorId berbasis indeks akan ditetapkan ke opsi pencocokan terbaik secara otomatis. Opsional. Defaultnya adalah Salah.
|
Otorisasi
Permintaan ini memerlukan otorisasi dengan cakupan berikut:
Cakupan |
---|
https://www.googleapis.com/auth/calendar |
Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.
Isi permintaan
Dalam isi permintaan, berikan resource CalendarList dengan properti berikut:
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
Properti yang Diperlukan | |||
id |
string |
ID kalender. | |
Properti Opsional | |||
backgroundColor |
string |
Warna utama kalender dalam format heksadesimal "#0088aa ". Properti ini menggantikan properti colorId berbasis indeks. Untuk menetapkan atau mengubah properti ini, Anda harus menentukan colorRgbFormat=true dalam parameter metode insert, update, dan patch. Opsional. |
dapat ditulis |
colorId |
string |
Warna kalender. Ini adalah ID yang merujuk ke entri di bagian calendar dari definisi warna (lihat endpoint warna). Properti ini digantikan oleh properti backgroundColor dan foregroundColor serta dapat diabaikan saat menggunakan properti ini. Opsional. |
dapat ditulis |
defaultReminders[] |
list |
Pengingat default yang dimiliki pengguna terautentikasi untuk kalender ini. | dapat ditulis |
defaultReminders[].method |
string |
Metode yang digunakan oleh pengingat ini. Kemungkinan nilainya adalah:
Wajib diisi saat menambahkan pengingat. |
dapat ditulis |
defaultReminders[].minutes |
integer |
Jumlah menit sebelum acara dimulai saat pengingat akan dipicu. Nilai yang valid adalah antara 0 dan 40320 (4 minggu dalam menit). Wajib diisi saat menambahkan pengingat. |
dapat ditulis |
foregroundColor |
string |
Warna latar depan kalender dalam format heksadesimal "#ffffff ". Properti ini menggantikan properti colorId berbasis indeks. Untuk menetapkan atau mengubah properti ini, Anda harus menentukan colorRgbFormat=true dalam parameter metode insert, update, dan patch. Opsional. |
dapat ditulis |
notificationSettings |
object |
Notifikasi yang diterima pengguna terautentikasi untuk kalender ini. | dapat ditulis |
notificationSettings.notifications[].method |
string |
Metode yang digunakan untuk mengirimkan notifikasi. Nilai yang mungkin adalah:
Diperlukan saat menambahkan notifikasi. |
dapat ditulis |
notificationSettings.notifications[].type |
string |
Jenis notifikasi. Kemungkinan nilainya adalah:
Diperlukan saat menambahkan notifikasi. |
dapat ditulis |
selected |
boolean |
Apakah konten kalender muncul di UI kalender. Opsional. Defaultnya adalah Salah. | dapat ditulis |
summaryOverride |
string |
Ringkasan yang ditetapkan pengguna terautentikasi untuk kalender ini. Opsional. | dapat ditulis |
Respons
Jika berhasil, metode ini akan menampilkan resource CalendarList dalam isi respons.
Contoh
Catatan: Contoh kode yang tersedia untuk metode ini tidak merepresentasikan semua bahasa pemrograman yang didukung (lihat halaman library klien untuk mengetahui daftar bahasa yang didukung).
Java
Menggunakan library klien Java.
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
Menggunakan library klien Python.
calendar_list_entry = { 'id': 'calendarId' } created_calendar_list_entry = service.calendarList().insert(body=calendar_list_entry).execute() print created_calendar_list_entry['summary']
PHP
Menggunakan library klien PHP.
$calendarListEntry = new Google_Service_Calendar_CalendarListEntry(); $calendarListEntry->setId("calendarId"); $createdCalendarListEntry = $service->calendarList->insert($calendarListEntry); echo $createdCalendarListEntry->getSummary();
Ruby
Menggunakan library klien Ruby.
entry = Google::Apis::CalendarV3::CalendarListEntry.new( id: 'calendarId' ) result = client.insert_calendar_list(entry) print result.summary
Cobalah!
Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.