Events: insert

Catatan: Memerlukan otorisasi.

Membuat acara. Coba sekarang.

Permintaan

Permintaan HTTP

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

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".
Parameter kueri opsional
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 peristiwa. Versi 1 mengaktifkan dukungan untuk penyalinan ConferenceData serta untuk membuat konferensi baru menggunakan kolom createRequest dari conferenceData. Defaultnya adalah 0. Nilai yang dapat diterima adalah 0 hingga 1, inklusif.
maxAttendees	integer	Jumlah maksimum tamu yang akan disertakan dalam respons. Jika jumlah peserta lebih banyak dari yang ditentukan, hanya peserta yang akan ditampilkan. Opsional.
sendNotifications	boolean	Tidak digunakan lagi. Harap gunakan sendUpdates. Apakah akan mengirim notifikasi tentang pembuatan acara baru. Perhatikan bahwa beberapa email mungkin masih dikirim meskipun Anda menyetel nilai ke false. Defaultnya adalah false.
sendUpdates	string	Apakah akan mengirimkan notifikasi tentang pembuatan acara baru. Perhatikan bahwa beberapa email mungkin masih dikirim. Defaultnya adalah false. Nilai yang dapat diterima adalah: "all": Notifikasi dikirim ke semua tamu. "externalOnly": Notifikasi hanya dikirim ke tamu non-Google Kalender. "none": Tidak ada notifikasi yang dikirim. Peringatan: Menggunakan nilai none dapat menimbulkan efek buruk yang signifikan, termasuk peristiwa tidak disinkronkan ke kalender eksternal atau peristiwa hilang sama sekali bagi beberapa pengguna. 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 Events resource dengan properti berikut:

Nama properti	Nilai	Deskripsi	Catatan
Properti Wajib
end	nested object	Waktu berakhir (eksklusif) acara. Untuk acara berulang, ini adalah waktu berakhir instance pertama.
start	nested object	Waktu mulai (inklusif) acara. Untuk acara berulang, ini adalah waktu mulai instance pertama.
Properti Opsional
anyoneCanAddSelf	boolean	Apakah siapa pun dapat mengundang diri mereka sendiri ke acara (tidak digunakan lagi). Opsional. Defaultnya adalah False.	dapat ditulis
attachments[].fileUrl	string	Link URL ke lampiran. Untuk menambahkan lampiran file Google Drive, gunakan format yang sama seperti di properti alternateLink dari resource Files di Drive API. Wajib diisi saat menambahkan lampiran.	dapat ditulis
attendees[]	list	Peserta acara. Lihat panduan Acara dengan tamu untuk mengetahui informasi selengkapnya tentang cara menjadwalkan acara dengan pengguna kalender lain. Akun layanan harus menggunakan delegasi otoritas tingkat domain untuk mengisi daftar tamu.	dapat ditulis
attendees[].additionalGuests	integer	Jumlah tamu tambahan. Opsional. Defaultnya adalah 0.	dapat ditulis
attendees[].comment	string	Komentar respons peserta. Opsional.	dapat ditulis
attendees[].displayName	string	Nama tamu, jika tersedia. Opsional.	dapat ditulis
attendees[].email	string	Alamat email peserta, jika tersedia. Kolom ini harus ada saat menambahkan tamu. Alamat email harus valid sesuai dengan RFC5322. Wajib diisi saat menambahkan tamu.	dapat ditulis
attendees[].optional	boolean	Apakah ini adalah tamu opsional. Opsional. Defaultnya adalah False.	dapat ditulis
attendees[].resource	boolean	Apakah peserta adalah resource. Hanya dapat ditetapkan saat tamu ditambahkan ke acara untuk pertama kalinya. Modifikasi berikutnya akan diabaikan. Opsional. Defaultnya adalah False.	dapat ditulis
attendees[].responseStatus	string	Status respons peserta. Nilai yang mungkin adalah: "needsAction" - Tamu belum merespons undangan (direkomendasikan untuk acara baru). "declined" - Tamu telah menolak undangan. "tentative" - Tamu telah menerima undangan untuk sementara. "accepted" - Tamu telah menerima undangan. Peringatan: Jika Anda menambahkan acara menggunakan nilai declined, tentative, atau accepted, tamu yang setelan "Tambahkan undangan ke kalender saya"-nya disetel ke "Jika saya menanggapi undangan dalam email" atau "Hanya jika pengirim diketahui" mungkin akan direset tanggapannya ke needsAction dan tidak akan melihat acara di kalender mereka kecuali jika mereka mengubah tanggapan di email undangan acara. Selain itu, jika lebih dari 200 tamu diundang ke acara, status respons tidak akan diteruskan ke tamu.	dapat ditulis
birthdayProperties	nested object	Data ulang tahun atau acara khusus. Digunakan jika eventType adalah "birthday". Tidak dapat diubah.	dapat ditulis
birthdayProperties.type	string	Jenis ulang tahun atau acara khusus. Nilai yang mungkin adalah: "anniversary" - Hari jadi selain ulang tahun. Selalu memiliki contact. "birthday" - Acara ulang tahun. Nilai ini merupakan default. "custom" - Tanggal khusus yang labelnya ditentukan lebih lanjut di kolom customTypeName. Selalu memiliki contact. "other" - Tanggal khusus yang tidak termasuk dalam kategori lain, dan tidak memiliki label kustom. Selalu memiliki contact. "self" - Ulang tahun pemilik kalender. Tidak boleh memiliki contact. Calendar API hanya mendukung pembuatan acara dengan jenis "birthday". Jenis tidak dapat diubah setelah acara dibuat.	dapat ditulis
colorId	string	Warna acara. Ini adalah ID yang merujuk ke entri di bagian event dari definisi warna (lihat endpoint warna). Opsional.	dapat ditulis
conferenceData	nested object	Informasi terkait konferensi, seperti detail konferensi Google Meet. Untuk membuat detail konferensi baru, gunakan kolom createRequest. Untuk mempertahankan perubahan, jangan lupa untuk menyetel parameter permintaan conferenceDataVersion ke 1 untuk semua permintaan modifikasi peristiwa. Peringatan: Menggunakan kembali data konferensi Google Meet di berbagai acara dapat menyebabkan masalah akses dan mengekspos detail rapat kepada pengguna yang tidak diinginkan. Untuk membantu memastikan privasi rapat, selalu buat konferensi unik untuk setiap acara menggunakan kolom createRequest.	dapat ditulis
description	string	Deskripsi acara. Dapat berisi HTML. Opsional.	dapat ditulis
end.date	date	Tanggal, dalam format "yyyy-mm-dd", jika ini adalah acara sepanjang hari.	dapat ditulis
end.dateTime	datetime	Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone.	dapat ditulis
end.timeZone	string	Zona waktu tempat waktu ditentukan. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Europe/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk acara tunggal, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara.	dapat ditulis
eventType	string	Jenis peristiwa tertentu. Setelan ini tidak dapat diubah setelah acara dibuat. Nilai yang mungkin adalah: "birthday" - Acara khusus sepanjang hari dengan pengulangan tahunan. "default" - Acara reguler atau tidak ditentukan lebih lanjut. "focusTime" - Acara waktu fokus. "fromGmail" - Acara dari Gmail. Jenis acara ini tidak dapat dibuat. "outOfOffice" - Acara tidak di kantor. "workingLocation" - Peristiwa lokasi kerja.	dapat ditulis
extendedProperties.private	object	Properti yang bersifat pribadi untuk salinan acara yang muncul di kalender ini.	dapat ditulis
extendedProperties.shared	object	Properti yang dibagikan di antara salinan acara di kalender tamu lain.	dapat ditulis
focusTimeProperties	nested object	Data acara Waktu Fokus. Digunakan jika eventType adalah focusTime.	dapat ditulis
gadget.display	string	Mode tampilan gadget. Tidak digunakan lagi. Nilai yang mungkin adalah: "icon" - Gadget ditampilkan di samping judul acara dalam tampilan kalender. "chip" - Gadget ditampilkan saat peristiwa diklik.	dapat ditulis
gadget.height	integer	Tinggi gadget dalam piksel. Tinggi harus berupa bilangan bulat yang lebih besar dari 0. Opsional. Tidak digunakan lagi.	dapat ditulis
gadget.iconLink	string	URL ikon gadget. Skema URL harus berupa HTTPS. Tidak digunakan lagi.	dapat ditulis
gadget.link	string	URL gadget. Skema URL harus berupa HTTPS. Tidak digunakan lagi.	dapat ditulis
gadget.preferences	object	Preferensi.	dapat ditulis
gadget.title	string	Judul gadget. Tidak digunakan lagi.	dapat ditulis
gadget.type	string	Jenis gadget. Tidak digunakan lagi.	dapat ditulis
gadget.width	integer	Lebar gadget dalam piksel. Lebar harus berupa bilangan bulat yang lebih besar dari 0. Opsional. Tidak digunakan lagi.	dapat ditulis
guestsCanInviteOthers	boolean	Apakah peserta selain penyelenggara dapat mengundang orang lain ke acara. Opsional. Defaultnya adalah True.	dapat ditulis
guestsCanModify	boolean	Apakah tamu selain penyelenggara dapat mengubah acara. Opsional. Defaultnya adalah False.	dapat ditulis
guestsCanSeeOtherGuests	boolean	Apakah tamu selain penyelenggara dapat melihat siapa saja tamu acara. Opsional. Defaultnya adalah True.	dapat ditulis
id	string	ID buram peristiwa. Saat membuat acara baru satu kali atau berulang, Anda dapat menentukan ID-nya. ID yang diberikan harus mengikuti aturan berikut: Karakter yang diizinkan dalam ID adalah karakter yang digunakan dalam encoding base32hex, yaitu huruf kecil a-v dan digit 0-9, lihat bagian 3.1.2 dalam RFC2938 panjang ID harus antara 5 dan 1024 karakter ID harus unik per kalender Karena sifat sistem yang didistribusikan secara global, kami tidak dapat menjamin bahwa tabrakan ID akan terdeteksi pada saat pembuatan acara. Untuk meminimalkan risiko bentrokan, sebaiknya gunakan algoritma UUID yang sudah mapan seperti yang dijelaskan dalam RFC4122. Jika Anda tidak menentukan ID, ID akan dibuat secara otomatis oleh server. Perhatikan bahwa icalUID dan id tidak identik dan hanya salah satunya yang boleh diberikan pada saat pembuatan peristiwa. Salah satu perbedaan semantiknya adalah bahwa dalam acara berulang, semua kemunculan satu acara memiliki id yang berbeda, tetapi semuanya memiliki icalUID yang sama.	dapat ditulis
location	string	Lokasi geografis acara sebagai teks bebas. Opsional.	dapat ditulis
originalStartTime.date	date	Tanggal, dalam format "yyyy-mm-dd", jika ini adalah acara sepanjang hari.	dapat ditulis
originalStartTime.dateTime	datetime	Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone.	dapat ditulis
originalStartTime.timeZone	string	Zona waktu tempat waktu ditentukan. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Europe/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk acara tunggal, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara.	dapat ditulis
outOfOfficeProperties	nested object	Data acara tidak di kantor. Digunakan jika eventType adalah outOfOffice.	dapat ditulis
recurrence[]	list	Daftar baris RRULE, EXRULE, RDATE, dan EXDATE untuk acara berulang, seperti yang ditentukan dalam RFC5545. Perhatikan bahwa baris DTSTART dan DTEND tidak diizinkan dalam kolom ini; waktu mulai dan akhir acara ditentukan dalam kolom start dan end. Kolom ini tidak disertakan untuk acara tunggal atau instance acara berulang.	dapat ditulis
reminders.overrides[]	list	Jika acara tidak menggunakan pengingat default, bagian ini akan mencantumkan pengingat khusus untuk acara tersebut, atau, jika tidak disetel, menunjukkan bahwa tidak ada pengingat yang disetel untuk acara ini. Jumlah maksimum pengingat penggantian adalah 5.	dapat ditulis
reminders.overrides[].method	string	Metode yang digunakan oleh pengingat ini. Nilai yang mungkin adalah: "email" - Pengingat dikirim melalui email. "popup" - Pengingat dikirim melalui pop-up UI. Wajib diisi saat menambahkan pengingat.	dapat ditulis
reminders.overrides[].minutes	integer	Jumlah menit sebelum acara dimulai saat pengingat harus dipicu. Nilai yang valid adalah antara 0 dan 40320 (4 minggu dalam menit). Wajib diisi saat menambahkan pengingat.	dapat ditulis
reminders.useDefault	boolean	Apakah pengingat default kalender berlaku untuk acara.	dapat ditulis
sequence	integer	Nomor urut sesuai iCalendar.	dapat ditulis
source.title	string	Judul sumber; misalnya, judul halaman web atau subjek email.	dapat ditulis
source.url	string	URL sumber yang mengarah ke resource. Skema URL harus berupa HTTP atau HTTPS.	dapat ditulis
start.date	date	Tanggal, dalam format "yyyy-mm-dd", jika ini adalah acara sepanjang hari.	dapat ditulis
start.dateTime	datetime	Waktu, sebagai nilai tanggal-waktu gabungan (diformat sesuai dengan RFC3339). Offset zona waktu diperlukan kecuali jika zona waktu ditentukan secara eksplisit di timeZone.	dapat ditulis
start.timeZone	string	Zona waktu tempat waktu ditentukan. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Europe/Zurich".) Untuk acara berulang, kolom ini wajib diisi dan menentukan zona waktu tempat pengulangan diperluas. Untuk acara tunggal, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk awal/akhir acara.	dapat ditulis
status	string	Status acara. Opsional. Nilai yang mungkin adalah: "confirmed" - Acara dikonfirmasi. Ini adalah status default. "tentative" - Acara sementara dikonfirmasi. "cancelled" - Acara dibatalkan (dihapus). Metode list hanya menampilkan acara yang dibatalkan pada sinkronisasi inkremental (jika syncToken atau updatedMin ditentukan) atau jika tanda showDeleted disetel ke true. Metode get selalu menampilkannya. Status dibatalkan mewakili dua status berbeda, bergantung pada jenis peristiwanya: Pengecualian yang dibatalkan dari acara berulang yang tidak dibatalkan menunjukkan bahwa instance ini tidak boleh lagi ditampilkan kepada pengguna. Klien harus menyimpan peristiwa ini selama masa aktif acara rutin induk. Pengecualian yang dibatalkan hanya dijamin memiliki nilai untuk kolom id, recurringEventId, dan originalStartTime yang diisi. Kolom lainnya mungkin kosong. Semua acara lain yang dibatalkan mewakili acara yang dihapus. Klien harus menghapus salinan yang disinkronkan secara lokal. Acara yang dibatalkan tersebut pada akhirnya akan hilang, jadi jangan mengandalkan ketersediaannya tanpa batas waktu. Peristiwa yang dihapus hanya dijamin memiliki kolom id yang terisi. Di kalender penyelenggara, acara yang dibatalkan terus menampilkan detail acara (ringkasan, lokasi, dll.) sehingga dapat dipulihkan (dibatalkan penghapusannya). Demikian pula, acara yang mengundang pengguna dan yang dihapus secara manual oleh pengguna akan terus memberikan detail. Namun, permintaan sinkronisasi inkremental dengan showDeleted yang disetel ke salah (false) tidak akan menampilkan detail ini. Jika penyelenggara acara berubah (misalnya melalui operasi pindah) dan penyelenggara asli tidak ada dalam daftar peserta, acara yang dibatalkan akan ditinggalkan dan hanya kolom id yang dijamin terisi.	dapat ditulis
summary	string	Judul acara.	dapat ditulis
transparency	string	Apakah acara memblokir waktu di kalender. Opsional. Nilai yang mungkin adalah: "opaque" - Nilai default. Acara tersebut memblokir waktu di kalender. Tindakan ini sama dengan menyetel Tampilkan saya sebagai ke Sibuk di UI Kalender. "transparent" - Acara tidak memblokir waktu di kalender. Tindakan ini sama dengan menyetel Tampilkan saya sebagai ke Tersedia di UI Kalender.	dapat ditulis
visibility	string	Visibilitas acara. Opsional. Nilai yang mungkin adalah: "default" - Menggunakan visibilitas default untuk acara di kalender. Nilai ini merupakan default. "public" - Acara bersifat publik dan detail acara dapat dilihat oleh semua pembaca kalender. "private" - Acara bersifat pribadi dan hanya peserta acara yang dapat melihat detail acara. "confidential" - Acara bersifat pribadi. Nilai ini diberikan karena alasan kompatibilitas.	dapat ditulis
workingLocationProperties	nested object	Data acara lokasi kerja.	dapat ditulis
workingLocationProperties.customLocation	object	Jika ada, menentukan bahwa pengguna bekerja dari lokasi kustom.	dapat ditulis
workingLocationProperties.customLocation.label	string	Label tambahan opsional untuk informasi tambahan.	dapat ditulis
workingLocationProperties.homeOffice	any value	Jika ada, menentukan bahwa pengguna sedang bekerja di rumah.	dapat ditulis
workingLocationProperties.officeLocation	object	Jika ada, menentukan bahwa pengguna bekerja dari kantor.	dapat ditulis
workingLocationProperties.officeLocation.buildingId	string	ID gedung opsional. Kolom ini harus merujuk ke ID gedung dalam database Sumber Daya organisasi.	dapat ditulis
workingLocationProperties.officeLocation.deskId	string	ID meja opsional.	dapat ditulis
workingLocationProperties.officeLocation.floorId	string	ID lantai opsional.	dapat ditulis
workingLocationProperties.officeLocation.floorSectionId	string	ID bagian lantai opsional.	dapat ditulis
workingLocationProperties.officeLocation.label	string	Nama kantor yang ditampilkan di klien Web dan Seluler Kalender. Sebaiknya Anda merujuk nama gedung di database Sumber Daya organisasi.	dapat ditulis
workingLocationProperties.type	string	Jenis lokasi kerja. Nilai yang mungkin adalah: "homeOffice" - Pengguna sedang bekerja di rumah. "officeLocation" - Pengguna bekerja dari kantor. "customLocation" - Pengguna bekerja dari lokasi kustom. Detail apa pun ditentukan dalam sub-kolom dari nama yang ditentukan, tetapi kolom ini mungkin tidak ada jika kosong. Kolom lainnya akan diabaikan. Wajib diisi saat menambahkan properti lokasi kerja.	dapat ditulis

Respons

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

Cobalah!

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