Events: patch

Memperbarui acara. Metode ini mendukung semantik patch. Perhatikan bahwa setiap permintaan patch menggunakan tiga unit kuota; lebih suka menggunakan get yang diikuti dengan update. Nilai kolom yang Anda tentukan akan menggantikan nilai yang ada. Kolom yang tidak Anda tetapkan dalam permintaan tetap tidak berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; tindakan 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 dari 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 tamu, meskipun tidak ada alamat email sebenarnya yang tersedia (yaitu nilai yang 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 pembuatan konferensi baru menggunakan kolom createRequest dari konferensiData. Defaultnya adalah 0. Nilai yang dapat diterima adalah 0 hingga 1, inklusif.
maxAttendees integer Jumlah maksimum peserta yang akan disertakan dalam respons. Jika jumlah tamu melebihi jumlah yang ditentukan, hanya peserta yang akan ditampilkan. Opsional.
sendNotifications boolean Tidak digunakan lagi. Sebagai gantinya, gunakan sendUpdates.

Apakah akan mengirim notifikasi tentang pembaruan acara (misalnya, perubahan deskripsi, dll.). Perlu diperhatikan 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 dikirim hanya kepada tamu yang bukan pengguna Google Kalender.
  • "none": Tidak ada notifikasi yang dikirim. Untuk tugas migrasi kalender, pertimbangkan untuk menggunakan metode Events.import.
supportsAttachments boolean Apakah klien API yang melakukan operasi mendukung lampiran peristiwa. Opsional. Default-nya adalah Salah.

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

Untuk informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, sediakan bagian yang relevan dari Resource peristiwa, sesuai dengan aturan semantik patch.

Respons

Jika berhasil, metode ini akan menampilkan Resource peristiwa dalam isi respons.

Cobalah!

Gunakan APIs Explorer di bawah untuk memanggil metode ini pada data live dan melihat respons.