Calendars: update

Memperbarui metadata untuk kalender. Coba sekarang.

Permintaan

Permintaan HTTP

PUT https://www.googleapis.com/calendar/v3/calendars/calendarId

Parameter

Nama parameter Nilai Deskripsi
Parameter jalur
calendarId string ID kalender. Untuk mengambil ID kalender, panggil metode calendarList.list. Jika Anda ingin mengakses kalender utama pengguna yang saat ini login, gunakan kata kunci "primary".

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:

Cakupan
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.app.created
https://www.googleapis.com/auth/calendar.calendars

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan resource Kalender dengan properti berikut:

Nama properti Nilai Deskripsi Catatan
Properti Opsional
description string Deskripsi kalender. Opsional. dapat ditulis
labelProperties nested object Properti label yang ditentukan di kalender ini. Jika ditentukan, akan menimpa properti label yang ada. Jika tidak ditentukan, properti label tidak akan berubah. dapat ditulis
labelProperties.eventLabels[] list Label acara yang ditentukan di kalender ini. Jika ada saat memperbarui kalender, label ini akan menggantikan label acara yang ada.

Perluas daftar untuk menambahkan label acara baru, dan hapus entitas dari daftar untuk menghapus label dari kalender.

Setiap kalender dapat memiliki maksimum 200 label.

 dapat ditulis
labelProperties.eventLabels[].backgroundColor string Warna latar belakang label dalam format heksadesimal, seperti "#039be5". Acara dengan label ini ditampilkan dalam warna ini. Wajib. dapat ditulis
labelProperties.eventLabels[].id string ID label. Opsional saat menyisipkan label baru. Jika tidak diberikan, ID unik akan dibuat. Wajib diisi saat memperbarui label.

Jika diberikan, ID harus unik dalam kalender dan mengikuti format UUID.

 dapat ditulis
labelProperties.eventLabels[].name string Nama label. Opsional.

Jika diberikan, ini harus memiliki maksimal 50 karakter.

 dapat ditulis
location string Lokasi geografis kalender sebagai teks bentuk bebas. Opsional. dapat ditulis
summary string Judul kalender. dapat ditulis
timeZone string Zona waktu kalender. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Europe/Zurich".) Opsional. dapat ditulis
workingHours object Menampilkan informasi tentang jam kerja pengguna. Hanya tersedia untuk kalender utama pengguna Google Workspace. Untuk memperbarui jam kerja, seluruh objek jam kerja harus diteruskan. Jika tidak ditentukan (atau diteruskan sebagai null atau objek kosong), jam kerja yang ada tidak akan berubah. Untuk menonaktifkan jam kerja atau menghapus jadwal, tetapkan workingHoursEnabled ke false (dan hapus availableTimes atau teruskan daftar kosong). dapat ditulis
workingHours.availableTimes[] list Jam kerja. Setiap periode ketersediaan mewakili blok jam kerja pengguna selama satu hari. dapat ditulis
workingHours.availableTimes[].dayOfWeek string Hari. Wajib. Nilai yang memungkinkan adalah:
  • "monday"
  • "tuesday"
  • "wednesday"
  • "thursday"
  • "friday"
  • "saturday"
  • "sunday"
dapat ditulis
workingHours.availableTimes[].periodEnd integer Akhir periode, dalam menit dari awal hari, eksklusif. Wajib. dapat ditulis
workingHours.availableTimes[].periodStart integer Awal periode, dalam menit dari awal hari, inklusif. Wajib. dapat ditulis
workingHours.workingHoursEnabled boolean Apakah jam kerja diaktifkan untuk kalender ini. Tidak dapat ditetapkan ke benar jika availableTimes kosong. dapat ditulis

Respons

Jika berhasil, metode ini akan menampilkan resource Kalender dalam isi respons.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data langsung dan melihat responsnya.