Calendar API menyediakan berbagai ragam resource acara. Informasi selengkapnya dapat ditemukan di Tentang acara.
Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.
Representasi resource
{ "kind": "calendar#event", "etag": etag, "id": string, "status": string, "htmlLink": string, "created": datetime, "updated": datetime, "summary": string, "description": string, "location": string, "colorId": string, "creator": { "id": string, "email": string, "displayName": string, "self": boolean }, "organizer": { "id": string, "email": string, "displayName": string, "self": boolean }, "start": { "date": date, "dateTime": datetime, "timeZone": string }, "end": { "date": date, "dateTime": datetime, "timeZone": string }, "endTimeUnspecified": boolean, "recurrence": [ string ], "recurringEventId": string, "originalStartTime": { "date": date, "dateTime": datetime, "timeZone": string }, "transparency": string, "visibility": string, "iCalUID": string, "sequence": integer, "attendees": [ { "id": string, "email": string, "displayName": string, "organizer": boolean, "self": boolean, "resource": boolean, "optional": boolean, "responseStatus": string, "comment": string, "additionalGuests": integer } ], "attendeesOmitted": boolean, "extendedProperties": { "private": { (key): string }, "shared": { (key): string } }, "hangoutLink": string, "conferenceData": { "createRequest": { "requestId": string, "conferenceSolutionKey": { "type": string }, "status": { "statusCode": string } }, "entryPoints": [ { "entryPointType": string, "uri": string, "label": string, "pin": string, "accessCode": string, "meetingCode": string, "passcode": string, "password": string } ], "conferenceSolution": { "key": { "type": string }, "name": string, "iconUri": string }, "conferenceId": string, "signature": string, "notes": string, }, "gadget": { "type": string, "title": string, "link": string, "iconLink": string, "width": integer, "height": integer, "display": string, "preferences": { (key): string } }, "anyoneCanAddSelf": boolean, "guestsCanInviteOthers": boolean, "guestsCanModify": boolean, "guestsCanSeeOtherGuests": boolean, "privateCopy": boolean, "locked": boolean, "reminders": { "useDefault": boolean, "overrides": [ { "method": string, "minutes": integer } ] }, "source": { "url": string, "title": string }, "workingLocationProperties": { "type": string, "homeOffice": (value), "customLocation": { "label": string }, "officeLocation": { "buildingId": string, "floorId": string, "floorSectionId": string, "deskId": string, "label": string } }, "outOfOfficeProperties": { "autoDeclineMode": string, "declineMessage": string }, "focusTimeProperties": { "autoDeclineMode": string, "declineMessage": string, "chatStatus": string }, "attachments": [ { "fileUrl": string, "title": string, "mimeType": string, "iconLink": string, "fileId": string } ], "birthdayProperties": { "contact": string, "type": string, "customTypeName": string }, "eventType": string }
Nama properti | Nilai | Deskripsi | Catatan |
---|---|---|---|
anyoneCanAddSelf |
boolean |
Apakah siapa saja dapat mengundang diri mereka sendiri ke acara (tidak digunakan lagi). Opsional. Default-nya adalah Salah. | dapat ditulis |
attachments[] |
list |
Lampiran file untuk acara. Untuk mengubah lampiran, parameter permintaan Maksimal 25 lampiran per acara, |
|
attachments[].fileId |
string |
ID file terlampir. Hanya baca. Untuk file Google Drive, ini adalah ID entri resource |
|
attachments[].fileUrl |
string |
Link URL ke lampiran. Untuk menambahkan lampiran file Google Drive, gunakan format yang sama seperti di properti Diperlukan saat menambahkan lampiran. |
dapat ditulis |
attachments[].iconLink |
string |
Link URL ke ikon lampiran. Kolom ini hanya dapat diubah untuk lampiran pihak ketiga kustom. | |
attachments[].mimeType |
string |
Jenis media internet (jenis MIME) lampiran. | |
attachments[].title |
string |
Judul lampiran. | |
attendeesOmitted |
boolean |
Apakah tamu mungkin telah dihilangkan dari representasi acara. Saat mengambil peristiwa, hal ini mungkin disebabkan oleh batasan yang ditentukan oleh parameter kueri maxAttendee . Saat memperbarui peristiwa, opsi ini dapat digunakan untuk hanya memperbarui respons peserta. Opsional. Default-nya adalah Salah. |
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 seluruh 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 peserta, 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[].id |
string |
ID Profil peserta, jika tersedia. | |
attendees[].optional |
boolean |
Apakah ini adalah tamu opsional. Opsional. Defaultnya adalah Salah. | dapat ditulis |
attendees[].organizer |
boolean |
Apakah tamu adalah penyelenggara acara. Hanya baca. Default-nya adalah Salah. | |
attendees[].resource |
boolean |
Apakah peserta adalah sumber daya. Hanya dapat ditetapkan saat tamu ditambahkan ke acara untuk pertama kalinya. Modifikasi berikutnya akan diabaikan. Opsional. Default-nya adalah Salah. | dapat ditulis |
attendees[].responseStatus |
string |
Status respons tamu. Kemungkinan nilainya adalah:
|
dapat ditulis |
attendees[].self |
boolean |
Apakah entri ini mewakili kalender tempat salinan acara ini muncul. Hanya baca. Default-nya adalah Salah. | |
birthdayProperties |
nested object |
Data tanggal lahir atau peristiwa spesial. Digunakan jika eventType adalah "birthday" . Tidak dapat diubah. |
dapat ditulis |
birthdayProperties.contact |
string |
Nama resource kontak yang tertaut dengan acara ulang tahun ini. Ini dapat digunakan untuk mengambil detail kontak dari People API. Format: "people/c12345" . Hanya baca. |
|
birthdayProperties.customTypeName |
string |
Label jenis kustom yang ditentukan untuk peristiwa ini. Kolom ini diisi jika birthdayProperties.type ditetapkan ke "custom" . Hanya baca. |
|
birthdayProperties.type |
string |
Jenis ulang tahun atau acara spesial. Kemungkinan nilainya adalah:
"birthday" . Jenis tidak dapat diubah setelah peristiwa dibuat. |
dapat ditulis |
colorId |
string |
Warna peristiwa. Ini adalah ID yang merujuk ke entri di bagian event 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 menetapkan parameter permintaan conferenceDataVersion ke 1 untuk semua permintaan perubahan peristiwa. |
dapat ditulis |
conferenceData.conferenceId |
string |
ID konferensi. Dapat digunakan oleh developer untuk melacak konferensi, tidak boleh ditampilkan kepada pengguna. Nilai ID dibentuk secara berbeda untuk setiap jenis solusi konferensi:
|
|
conferenceData.conferenceSolution |
nested object |
Solusi konferensi, seperti Google Meet. Hapus setelan untuk konferensi dengan permintaan pembuatan yang gagal.
|
|
conferenceData.conferenceSolution.iconUri |
string |
Ikon yang dapat dilihat pengguna untuk solusi ini. | |
conferenceData.conferenceSolution.key |
nested object |
Kunci yang dapat mengidentifikasi solusi konferensi secara unik untuk peristiwa ini. | |
conferenceData.conferenceSolution.key.type |
string |
Jenis solusi konferensi. Jika klien menemukan jenis yang tidak dikenal atau kosong, klien tersebut masih dapat menampilkan titik entri. Namun, file tersebut tidak boleh diubah. Kemungkinan nilainya adalah:
|
|
conferenceData.conferenceSolution.name |
string |
Nama solusi ini yang terlihat oleh pengguna. Tidak dilokalkan. | |
conferenceData.createRequest |
nested object |
Permintaan untuk membuat konferensi baru dan melampirkan konferensi tersebut ke peristiwa. Data dibuat secara asinkron. Untuk melihat apakah data ada, periksa kolom status .
|
|
conferenceData.createRequest.conferenceSolutionKey |
nested object |
Solusi konferensi, seperti Hangouts atau Google Meet. | |
conferenceData.createRequest.conferenceSolutionKey.type |
string |
Jenis solusi konferensi. Jika klien menemukan jenis yang tidak dikenal atau kosong, klien tersebut masih dapat menampilkan titik entri. Namun, file tersebut tidak boleh diubah. Kemungkinan nilainya adalah:
|
|
conferenceData.createRequest.requestId |
string |
ID unik yang dibuat klien untuk permintaan ini. Klien harus membuat ulang ID ini untuk setiap permintaan baru. Jika ID yang diberikan sama dengan permintaan sebelumnya, permintaan tersebut akan diabaikan. |
|
conferenceData.createRequest.status |
nested object |
Status permintaan pembuatan konferensi. | |
conferenceData.createRequest.status.statusCode |
string |
Status permintaan pembuatan konferensi saat ini. Hanya baca. Kemungkinan nilainya adalah:
|
|
conferenceData.entryPoints[] |
list |
Informasi tentang setiap titik entri konferensi, seperti URL atau nomor telepon. Semuanya harus berasal dari konferensi yang sama.
|
|
conferenceData.entryPoints[].accessCode |
string |
Kode akses untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subkumpulan kolom { Opsional. |
|
conferenceData.entryPoints[].entryPointType |
string |
Jenis titik entri konferensi. Nilai yang dimungkinkan adalah:
|
|
conferenceData.entryPoints[].label |
string |
Label untuk URI. Dapat dilihat oleh pengguna akhir. Tidak dilokalkan. Panjang maksimum adalah 512 karakter. Contoh:
Opsional. |
|
conferenceData.entryPoints[].meetingCode |
string |
Kode rapat untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subkumpulan kolom { Opsional. |
|
conferenceData.entryPoints[].passcode |
string |
Kode sandi untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subkumpulan kolom { |
|
conferenceData.entryPoints[].password |
string |
Sandi untuk mengakses konferensi. Panjang maksimumnya adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subkumpulan kolom { Opsional. |
|
conferenceData.entryPoints[].pin |
string |
PIN untuk mengakses konferensi. Panjang maksimumnya adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subkumpulan kolom { Opsional. |
|
conferenceData.entryPoints[].uri |
string |
URI titik entri. Panjang maksimumnya adalah 1.300 karakter. Format:
|
|
conferenceData.notes |
string |
Catatan tambahan (seperti petunjuk dari administrator domain, pemberitahuan hukum) untuk ditampilkan kepada pengguna. Dapat berisi HTML. Panjang maksimum adalah 2.048 karakter. Opsional. | |
conferenceData.signature |
string |
Tanda tangan data konferensi. Dibuat di sisi server. Hapus setelan untuk konferensi dengan permintaan pembuatan yang gagal. Opsional untuk konferensi dengan permintaan pembuatan yang tertunda. |
|
created |
datetime |
Waktu pembuatan peristiwa (sebagai stempel waktu RFC3339). Hanya baca. | |
creator |
object |
Pembuat acara. Hanya baca. | |
creator.displayName |
string |
Nama kreator, jika tersedia. | |
creator.email |
string |
Alamat email kreator, jika tersedia. | |
creator.id |
string |
ID Profil kreator, jika tersedia. | |
creator.self |
boolean |
Apakah pembuatnya sesuai dengan kalender tempat salinan acara ini muncul. Hanya baca. Default-nya adalah Salah. | |
description |
string |
Deskripsi acara. Dapat berisi HTML. Opsional. | dapat ditulis |
end |
nested object |
Waktu berakhir (eksklusif) acara. Untuk acara berulang, ini adalah waktu berakhirnya acara yang pertama. | |
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 "Eropa/Zurich".) Untuk acara berulang, kolom ini diperlukan dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu peristiwa, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk waktu mulai/akhir peristiwa. | dapat ditulis |
endTimeUnspecified |
boolean |
Apakah waktu berakhir benar-benar tidak ditentukan. Waktu berakhir masih diberikan karena alasan kompatibilitas, meskipun atribut ini disetel ke True. Defaultnya adalah Salah. | |
etag |
etag |
ETag resource. | |
eventType |
string |
Jenis peristiwa tertentu. Setelan ini tidak dapat diubah setelah acara dibuat. Kemungkinan nilainya adalah:
|
dapat ditulis |
extendedProperties |
object |
Properti yang diperluas dari peristiwa. | |
extendedProperties.private |
object |
Properti yang bersifat pribadi untuk salinan acara yang muncul di kalender ini. | dapat ditulis |
extendedProperties.private.(key) |
string |
Nama properti pribadi dan nilai yang sesuai. | |
extendedProperties.shared |
object |
Properti yang dibagikan di antara salinan acara di kalender tamu lain. | dapat ditulis |
extendedProperties.shared.(key) |
string |
Nama properti bersama dan nilai yang sesuai. | |
focusTimeProperties |
nested object |
Data peristiwa Waktu Fokus. Digunakan jika eventType adalah focusTime . |
dapat ditulis |
focusTimeProperties.autoDeclineMode |
string |
Apakah akan menolak undangan rapat yang tumpang-tindih dengan acara Waktu Fokus. Nilai yang valid adalah declineNone , artinya tidak ada undangan rapat yang ditolak; declineAllConflictingInvitations , artinya semua undangan rapat yang bentrok dan bentrok dengan acara tersebut akan ditolak; dan declineOnlyNewConflictingInvitations , artinya hanya undangan rapat baru yang bentrok dan tiba saat acara Waktu Fokus ada yang akan ditolak. |
|
focusTimeProperties.chatStatus |
string |
Status untuk menandai pengguna di Chat dan produk terkait. Nilai ini dapat berupa available atau doNotDisturb . |
|
focusTimeProperties.declineMessage |
string |
Pesan respons yang akan ditetapkan jika acara yang ada atau undangan baru otomatis ditolak oleh Kalender. | |
gadget |
object |
Gadget yang memperluas peristiwa ini. Gadget tidak digunakan lagi; struktur ini hanya digunakan untuk menampilkan metadata kalender ulang tahun. | |
gadget.display |
string |
Mode tampilan gadget. Tidak digunakan lagi. Kemungkinan nilainya adalah:
|
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.preferences.(key) |
string |
Nama preferensi dan nilai yang sesuai. | |
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 peserta selain penyelenggara dapat mengubah acara. Opsional. Defaultnya adalah Salah. | dapat ditulis |
guestsCanSeeOtherGuests |
boolean |
Apakah peserta selain penyelenggara dapat melihat siapa saja peserta acara. Opsional. Defaultnya adalah True. | dapat ditulis |
hangoutLink |
string |
Link absolut ke Google Hangout yang terkait dengan acara ini. Hanya baca. | |
htmlLink |
string |
Link absolut ke acara ini di UI Web Google Kalender. Hanya baca. | |
iCalUID |
string |
ID unik peristiwa seperti yang didefinisikan dalam RFC5545. ID ini digunakan untuk mengidentifikasi peristiwa secara unik di seluruh sistem kalender dan harus diberikan saat mengimpor peristiwa melalui metode import. Perhatikan bahwa |
|
id |
string |
ID tersembunyi peristiwa. Saat membuat peristiwa tunggal atau berulang baru, Anda dapat menentukan ID-nya. ID yang diberikan harus mengikuti aturan berikut:
Jika Anda tidak menentukan ID, ID akan dibuat secara otomatis oleh server. Perhatikan bahwa |
dapat ditulis |
kind |
string |
Jenis resource ("calendar#event "). |
|
location |
string |
Lokasi geografis peristiwa sebagai teks bebas. Opsional. | dapat ditulis |
locked |
boolean |
Apakah ini adalah salinan acara terkunci yang tidak dapat diubah pada kolom acara utama "ringkasan", "deskripsi", "lokasi", "awal", "akhir", atau "pengulangan". Default-nya adalah Salah. Hanya Baca. | |
organizer |
object |
Penyelenggara acara. Jika penyelenggara juga merupakan tamu, hal ini ditunjukkan dengan entri terpisah di attendees dengan kolom organizer ditetapkan ke Benar. Untuk mengubah penyelenggara, gunakan operasi pindahkan. Hanya baca, kecuali saat mengimpor peristiwa. |
dapat ditulis |
organizer.displayName |
string |
Nama penyelenggara, jika tersedia. | dapat ditulis |
organizer.email |
string |
Alamat email penyelenggara, jika tersedia. Alamat email harus valid sesuai dengan RFC5322. | dapat ditulis |
organizer.id |
string |
ID Profil penyelenggara, jika tersedia. | |
organizer.self |
boolean |
Apakah penyelenggara sesuai dengan kalender tempat salinan acara ini muncul. Hanya baca. Default-nya adalah Salah. | |
originalStartTime |
nested object |
Untuk instance peristiwa berulang, ini adalah waktu saat peristiwa ini akan dimulai sesuai dengan data pengulangan dalam peristiwa berulang yang diidentifikasi oleh recurringEventId. ID ini mengidentifikasi instance secara unik dalam rangkaian peristiwa berulang meskipun instance dipindahkan ke waktu yang berbeda. Tidak dapat diubah. | |
originalStartTime.date |
date |
Tanggal, dalam format "yyyy-mm-dd", jika ini adalah peristiwa 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 "Eropa/Zurich".) Untuk acara berulang, kolom ini diperlukan dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu peristiwa, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk waktu mulai/akhir peristiwa. | dapat ditulis |
outOfOfficeProperties |
nested object |
Data acara tidak di kantor. Digunakan jika eventType adalah outOfOffice . |
dapat ditulis |
outOfOfficeProperties.autoDeclineMode |
string |
Apakah akan menolak undangan rapat yang tumpang-tindih dengan acara Tidak di kantor. Nilai yang valid adalah declineNone , yang berarti tidak ada undangan rapat yang ditolak; declineAllConflictingInvitations , yang berarti semua undangan rapat yang bentrok dengan acara akan ditolak; dan declineOnlyNewConflictingInvitations , yang berarti hanya undangan rapat baru yang bentrok yang diterima saat acara Tidak di kantor ada yang akan ditolak. |
|
outOfOfficeProperties.declineMessage |
string |
Pesan respons yang akan ditetapkan jika acara yang ada atau undangan baru otomatis ditolak oleh Kalender. | |
privateCopy |
boolean |
Jika disetel ke Benar (True), Penyebaran peristiwa akan dinonaktifkan. Perhatikan bahwa ini tidak sama dengan Properti peristiwa pribadi. Opsional. Tidak dapat diubah. Default-nya adalah Salah. | |
recurrence[] |
list |
Daftar baris RRules, EXRules, RDATE, dan EXDATE untuk acara berulang, seperti yang ditentukan dalam RFC5545. Perhatikan bahwa baris DTSTART dan DTEND tidak diizinkan di kolom ini; waktu mulai dan waktu berakhir acara ditentukan di kolom start dan end . Kolom ini dihilangkan untuk satu peristiwa atau instance peristiwa berulang. |
dapat ditulis |
recurringEventId |
string |
Untuk instance acara rutin, kode ini adalah id dari acara rutin yang memiliki instance ini. Tidak dapat diubah. |
|
reminders |
object |
Informasi tentang pengingat acara untuk pengguna terautentikasi. Perhatikan bahwa mengubah pengingat juga tidak mengubah properti updated dari peristiwa yang melampirkan. |
|
reminders.overrides[] |
list |
Jika acara tidak menggunakan pengingat default, pengingat khusus untuk acara tersebut akan dicantumkan, atau, jika tidak ditetapkan, menunjukkan bahwa tidak ada pengingat yang ditetapkan untuk acara ini. Jumlah maksimum pengingat penggantian adalah 5. | dapat ditulis |
reminders.overrides[].method |
string |
Metode yang digunakan oleh pengingat ini. Kemungkinan nilainya adalah:
Wajib diisi saat menambahkan pengingat. |
dapat ditulis |
reminders.overrides[].minutes |
integer |
Jumlah menit sebelum awal acara saat pengingat harus dipicu. Nilai yang valid 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 |
object |
Sumber tempat peristiwa dibuat. Misalnya, halaman web, pesan email, atau dokumen apa pun yang dapat diidentifikasi oleh URL dengan skema HTTP atau HTTPS. Hanya dapat dilihat atau diubah oleh pembuat acara. | |
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 |
nested object |
Waktu mulai (inklusif) acara. Untuk peristiwa berulang, ini adalah waktu mulai instance pertama. | |
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 "Eropa/Zurich".) Untuk acara berulang, kolom ini diperlukan dan menentukan zona waktu tempat pengulangan diperluas. Untuk satu peristiwa, kolom ini bersifat opsional dan menunjukkan zona waktu kustom untuk waktu mulai/akhir peristiwa. | dapat ditulis |
status |
string |
Status peristiwa. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
summary |
string |
Judul acara. | dapat ditulis |
transparency |
string |
Apakah acara memblokir waktu di kalender. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
updated |
datetime |
Waktu modifikasi terakhir data peristiwa utama (sebagai stempel waktu RFC3339). Memperbarui pengingat acara tidak akan menyebabkan perubahan ini. Hanya baca. | |
visibility |
string |
Visibilitas peristiwa. Opsional. Kemungkinan nilainya adalah:
|
dapat ditulis |
workingLocationProperties |
nested object |
Data peristiwa lokasi kerja. | dapat ditulis |
workingLocationProperties.customLocation |
object |
Jika ada, tentukan 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 bekerja di rumah. | dapat ditulis |
workingLocationProperties.officeLocation |
object |
Jika ada, menentukan bahwa pengguna bekerja dari kantor. | dapat ditulis |
workingLocationProperties.officeLocation.buildingId |
string |
ID bangunan opsional. URL ini harus merujuk ke ID gedung di database Resource 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 mereferensikan nama gedung di database Fasilitas organisasi. | dapat ditulis |
workingLocationProperties.type |
string |
Jenis lokasi kerja. Kemungkinan nilainya adalah:
Wajib saat menambahkan properti lokasi kerja. |
dapat ditulis |
Metode
- hapus
- Menghapus peristiwa.
- get
- Menampilkan acara berdasarkan ID Google Kalender-nya. Untuk mengambil peristiwa menggunakan ID iKalender-nya, panggil metode peristiwa.list menggunakan parameter
iCalUID
. - import
- Mengimpor peristiwa. Operasi ini digunakan untuk menambahkan salinan pribadi acara yang ada ke kalender. Hanya peristiwa dengan
eventType
default
yang dapat diimpor.Perilaku yang tidak digunakan lagi: Jika peristiwa non-
default
diimpor, jenisnya akan diubah menjadidefault
dan properti khusus jenis peristiwa yang mungkin dimilikinya akan dihapus. - insert
- Membuat peristiwa.
- instance
- Menampilkan instance acara berulang yang ditentukan.
- list
- Menampilkan acara di kalender yang ditentukan.
- move
- Memindahkan acara ke kalender lain, yaitu mengubah penyelenggara acara. Perhatikan bahwa hanya peristiwa
default
yang dapat dipindahkan; peristiwabirthday
,focusTime
,fromGmail
,outOfOffice
, danworkingLocation
tidak dapat dipindahkan. - patch
- Memperbarui peristiwa. Metode ini mendukung semantik patch. Perhatikan bahwa setiap permintaan patch menggunakan tiga unit kuota; sebaiknya gunakan
get
, diikuti denganupdate
. Nilai kolom yang Anda tentukan akan menggantikan nilai yang ada. Kolom yang tidak Anda tentukan dalam permintaan tetap tidak berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; tindakan ini akan menghapus elemen array sebelumnya. - quickAdd
- Membuat peristiwa berdasarkan string teks sederhana.
- update
- Memperbarui peristiwa. Metode ini tidak mendukung semantik patch dan selalu memperbarui seluruh resource peristiwa. Untuk melakukan pembaruan sebagian, lakukan
get
, diikuti denganupdate
menggunakan etags untuk memastikan atomitas. - watch
- Perhatikan perubahan pada resource Acara.