Events: patch

Memperbarui acara. Metode ini mendukung semantik patch. Perhatikan bahwa setiap permintaan patch menggunakan tiga unit kuota; sebaiknya gunakan get yang diikuti dengan update. Nilai kolom yang Anda tentukan akan menggantikan nilai yang ada. Kolom yang tidak Anda tentukan dalam permintaan akan tetap tidak berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; hal ini akan menghapus elemen array sebelumnya. Coba sekarang.

Permintaan

Permintaan HTTP

PATCH https://www.googleapis.com/calendar/v3/calendars/calendarId/events/eventId

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".
eventId string ID peristiwa.
Parameter kueri opsional
alwaysIncludeEmail boolean Tidak digunakan lagi dan diabaikan. Nilai akan selalu ditampilkan di kolom email untuk penyelenggara, pembuat, dan peserta, meskipun tidak ada alamat email yang sebenarnya (yaitu nilai yang dibuat dan tidak berfungsi akan diberikan).
conferenceDataVersion integer Nomor versi data konferensi yang didukung oleh klien API. Versi 0 mengasumsikan tidak ada dukungan data konferensi dan mengabaikan data konferensi di isi acara. Versi 1 memungkinkan dukungan untuk menyalin ConferenceData serta membuat konferensi baru menggunakan kolom createRequest conferenceData. Defaultnya adalah 0. Nilai yang dapat diterima adalah 0 hingga 1, inklusif.
eventLabelVersion integer Nomor versi fitur label acara yang didukung oleh klien API. Versi 0 mengasumsikan tidak ada dukungan label acara dan memproses kolom colorId untuk pengelolaan warna. Versi 1 memungkinkan dukungan untuk label acara, dan memproses eventLabelId di isi acara. Dalam hal ini, kolom colorId akan diabaikan. Defaultnya adalah 0. Nilai yang dapat diterima adalah 0 hingga 1, inklusif.
maxAttendees integer Jumlah maksimum peserta yang akan disertakan dalam respons. Jika ada lebih banyak peserta daripada jumlah yang ditentukan, hanya peserta yang akan ditampilkan. Opsional.
sendNotifications boolean Tidak digunakan lagi. Sebaiknya gunakan sendUpdates.

Apakah akan mengirim notifikasi tentang pembaruan acara (misalnya, perubahan deskripsi, dll.). Perhatikan bahwa beberapa email mungkin masih dikirim meskipun Anda menetapkan nilainya ke false. Defaultnya adalah false.
sendUpdates string Tamu yang akan menerima notifikasi tentang pembaruan acara (misalnya, perubahan judul, dll.).

Nilai yang dapat diterima adalah:
  • "all": Notifikasi dikirim ke semua tamu.
  • "externalOnly": Notifikasi hanya dikirim ke tamu non-Kalender Google.
  • "none": Tidak ada notifikasi yang dikirim. Untuk tugas migrasi kalender, sebaiknya gunakan metode Events.import.
supportsAttachments boolean Apakah klien API yang melakukan operasi mendukung lampiran acara. Opsional. Defaultnya adalah False.

Otorisasi

Permintaan ini memerlukan otorisasi dengan setidaknya salah satu cakupan berikut:

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

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan bagian yang relevan dari resource Events, sesuai dengan aturan semantik patch.

Respons

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

Cobalah!

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