Events

Calendar API menyediakan berbagai jenis 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 pun dapat mengundang diri mereka sendiri ke acara (tidak digunakan lagi). Opsional. Defaultnya adalah False.	dapat ditulis
attachments[]	list	Lampiran file untuk acara. Untuk mengubah lampiran, parameter permintaan supportsAttachments harus disetel ke true. Maksimal ada 25 lampiran per peristiwa,
attachments[].fileId	string	ID file terlampir. Hanya baca. Untuk file Google Drive, ini adalah ID entri resource Files yang sesuai di Drive API.
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
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 tidak disertakan dalam representasi acara. Saat mengambil peristiwa, hal ini mungkin disebabkan oleh batasan yang ditentukan oleh parameter kueri maxAttendee. Saat memperbarui acara, parameter ini dapat digunakan untuk memperbarui respons peserta saja. Opsional. Defaultnya adalah False.	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[].id	string	ID Profil tamu, jika tersedia.
attendees[].optional	boolean	Apakah ini adalah tamu opsional. Opsional. Defaultnya adalah False.	dapat ditulis
attendees[].organizer	boolean	Apakah tamu adalah penyelenggara acara. Hanya baca. Defaultnya adalah False.
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 menjadi 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
attendees[].self	boolean	Apakah entri ini mewakili kalender tempat salinan acara ini muncul. Hanya baca. Defaultnya adalah False.
birthdayProperties	nested object	Data ulang tahun atau acara khusus. Digunakan jika eventType adalah "birthday". Tidak dapat diubah.	dapat ditulis
birthdayProperties.contact	string	Nama resource kontak yang ditautkan ke acara ulang tahun ini. ID 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 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
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: eventHangout: ID tidak ditetapkan. (Jenis konferensi ini tidak digunakan lagi.) eventNamedHangout: ID adalah nama Hangout. (Jenis konferensi ini tidak digunakan lagi.) hangoutsMeet: ID adalah kode rapat 10 huruf, misalnya aaa-bbbb-ccc. addOn: ID ditentukan oleh penyedia pihak ketiga. Opsional.
conferenceData.conferenceSolution	nested object	Solusi konferensi, seperti Google Meet. Tidak disetel untuk konferensi dengan permintaan pembuatan yang gagal. conferenceSolution dan setidaknya satu entryPoint, atau createRequest harus ada.
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 acara ini.
conferenceData.conferenceSolution.key.type	string	Jenis solusi konferensi. Jika klien menemukan jenis yang tidak dikenal atau kosong, klien tetap dapat menampilkan titik entri. Namun, hal ini akan melarang modifikasi. Kemungkinan nilainya adalah: "eventHangout" untuk Hangouts bagi konsumen (tidak digunakan lagi; acara yang ada mungkin menampilkan jenis solusi konferensi ini, tetapi konferensi baru tidak dapat dibuat) "eventNamedHangout" untuk Hangouts klasik bagi pengguna Google Workspace (tidak digunakan lagi; acara yang ada mungkin menampilkan jenis solusi konferensi ini, tetapi konferensi baru tidak dapat dibuat) "hangoutsMeet" untuk Google Meet (http://meet.google.com) "addOn" untuk penyedia konferensi pihak ketiga
conferenceData.conferenceSolution.name	string	Nama solusi ini yang dapat dilihat oleh pengguna. Tidak dilokalkan.
conferenceData.createRequest	nested object	Permintaan untuk membuat konferensi baru dan melampirkannya ke acara. Data dibuat secara asinkron. Untuk melihat apakah data ada, periksa kolom status. conferenceSolution dan setidaknya satu entryPoint, atau createRequest harus ada.
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 tetap dapat menampilkan titik entri. Namun, hal ini akan melarang modifikasi. Kemungkinan nilainya adalah: "eventHangout" untuk Hangouts bagi konsumen (tidak digunakan lagi; acara yang ada mungkin menampilkan jenis solusi konferensi ini, tetapi konferensi baru tidak dapat dibuat) "eventNamedHangout" untuk Hangouts klasik bagi pengguna Google Workspace (tidak digunakan lagi; acara yang ada mungkin menampilkan jenis solusi konferensi ini, tetapi konferensi baru tidak dapat dibuat) "hangoutsMeet" untuk Google Meet (http://meet.google.com) "addOn" untuk penyedia konferensi pihak ketiga
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 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: "pending": permintaan pembuatan konferensi masih diproses. "success": permintaan pembuatan konferensi berhasil, titik entri diisi. "failure": permintaan pembuatan konferensi gagal, tidak ada titik entri.
conferenceData.entryPoints[]	list	Informasi tentang titik masuk konferensi individual, seperti URL atau nomor telepon. Semua peserta harus bergabung ke konferensi yang sama. conferenceSolution dan setidaknya satu entryPoint, atau createRequest harus ada.
conferenceData.entryPoints[].accessCode	string	Kode akses untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subset kolom {meetingCode, accessCode, passcode, password, pin} yang cocok dengan terminologi yang digunakan penyedia konferensi. Hanya kolom yang diisi yang akan ditampilkan. Opsional.
conferenceData.entryPoints[].entryPointType	string	Jenis titik entri konferensi. Nilai yang dimungkinkan adalah: "video" - bergabung ke konferensi melalui HTTP. Konferensi dapat memiliki nol atau satu titik akses video. "phone" - bergabung ke konferensi dengan menghubungi nomor telepon. Konferensi dapat memiliki nol atau lebih titik masuk phone. "sip" - bergabung ke konferensi melalui SIP. Konferensi dapat memiliki nol atau satu titik akses sip. "more" - petunjuk bergabung ke konferensi lebih lanjut, misalnya nomor telepon tambahan. Konferensi dapat memiliki nol atau satu titik akses more. Konferensi dengan hanya titik entri more bukanlah konferensi yang valid.
conferenceData.entryPoints[].label	string	Label untuk URI. Dapat dilihat oleh pengguna akhir. Tidak dilokalkan. Panjang maksimum adalah 512 karakter. Contoh: untuk video: meet.google.com/aaa-bbbb-ccc untuk phone: [phone] untuk sip: [e-mail] untuk more: tidak boleh diisi Opsional.
conferenceData.entryPoints[].meetingCode	string	Kode rapat untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subset kolom {meetingCode, accessCode, passcode, password, pin} yang cocok dengan terminologi yang digunakan penyedia konferensi. Hanya kolom yang diisi yang akan ditampilkan. Opsional.
conferenceData.entryPoints[].passcode	string	Kode sandi untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subset kolom {meetingCode, accessCode, passcode, password, pin} yang cocok dengan terminologi yang digunakan penyedia konferensi. Hanya kolom yang diisi yang akan ditampilkan.
conferenceData.entryPoints[].password	string	Sandi untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subset kolom {meetingCode, accessCode, passcode, password, pin} yang cocok dengan terminologi yang digunakan penyedia konferensi. Hanya kolom yang diisi yang akan ditampilkan. Opsional.
conferenceData.entryPoints[].pin	string	PIN untuk mengakses konferensi. Panjang maksimum adalah 128 karakter. Saat membuat data konferensi baru, isi hanya subset kolom {meetingCode, accessCode, passcode, password, pin} yang cocok dengan terminologi yang digunakan penyedia konferensi. Hanya kolom yang diisi yang akan ditampilkan. Opsional.
conferenceData.entryPoints[].uri	string	URI titik entri. Panjang maksimumnya adalah 1.300 karakter. Format: untuk skema video, http:, atau https: diperlukan. Untuk phone, skema tel: diperlukan. URI harus menyertakan seluruh urutan panggilan (misalnya, tel:[phone],,,123456789;1234). untuk skema sip, sip: diperlukan, misalnya, sip:[e-mail]. untuk skema more, http:, atau https: diperlukan.
conferenceData.notes	string	Catatan tambahan (seperti petunjuk dari administrator domain, pemberitahuan hukum) untuk ditampilkan kepada pengguna. Dapat berisi HTML. Panjang maksimum adalah 2048 karakter. Opsional.
conferenceData.signature	string	Tanda tangan data konferensi. Dibuat di sisi server. Tidak disetel untuk konferensi dengan permintaan pembuatan yang gagal. Opsional untuk konferensi dengan permintaan pembuatan yang menunggu keputusan.
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 pembuat sesuai dengan kalender tempat salinan acara ini muncul. Hanya baca. Defaultnya adalah False.
description	string	Deskripsi acara. Dapat berisi HTML. Opsional.	dapat ditulis
end	nested object	Waktu berakhir (eksklusif) acara. Untuk acara berulang, ini adalah waktu berakhir instance 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 "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
endTimeUnspecified	boolean	Apakah waktu berakhir sebenarnya tidak ditentukan. Waktu berakhir masih diberikan karena alasan kompatibilitas, meskipun atribut ini disetel ke True. Defaultnya adalah False.
etag	etag	ETag resource.
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	object	Properti tambahan acara.
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 acara 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, yang berarti tidak ada undangan rapat yang ditolak; declineAllConflictingInvitations, yang berarti semua undangan rapat yang berbenturan dengan acara akan ditolak; dan declineOnlyNewConflictingInvitations, yang berarti hanya undangan rapat baru yang berbenturan yang tiba saat acara Waktu Fokus berlangsung yang akan ditolak.
focusTimeProperties.chatStatus	string	Status untuk menandai pengguna di Chat dan produk terkait. Nilainya dapat berupa available atau doNotDisturb.
focusTimeProperties.declineMessage	string	Pesan respons yang akan ditetapkan jika acara yang sudah 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. 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.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 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
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 acara sebagaimana 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 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. Untuk mengambil peristiwa menggunakan iCalUID-nya, panggil metode events.list menggunakan parameter iCalUID. Untuk mengambil peristiwa menggunakan id-nya, panggil metode events.get.
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 di 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 tabrakan, 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
kind	string	Jenis resource ("calendar#event").
location	string	Lokasi geografis acara sebagai teks bebas. Opsional.	dapat ditulis
locked	boolean	Apakah ini salinan acara terkunci yang tidak dapat diubah pada kolom acara utama "ringkasan", "deskripsi", "lokasi", "mulai", "akhir", atau "pengulangan". Defaultnya adalah False. Hanya Baca.
organizer	object	Penyelenggara acara. Jika penyelenggara juga merupakan tamu, hal ini ditunjukkan dengan entri terpisah di attendees dengan kolom organizer yang ditetapkan ke True. Untuk mengubah penyelenggara, gunakan operasi move. Hanya baca, kecuali saat mengimpor acara.	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. Defaultnya adalah False.
originalStartTime	nested object	Untuk instance acara berulang, ini adalah waktu dimulainya acara ini menurut data pengulangan dalam acara berulang yang diidentifikasi oleh recurringEventId. ID ini mengidentifikasi instance secara unik dalam rangkaian acara berulang meskipun instance dipindahkan ke waktu yang berbeda. Tidak dapat diubah.
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
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 berkonflik dengan acara akan ditolak; dan declineOnlyNewConflictingInvitations, yang berarti hanya undangan rapat baru yang berkonflik yang tiba saat acara Sedang tidak di kantor berlangsung yang akan ditolak.
outOfOfficeProperties.declineMessage	string	Pesan respons yang akan ditetapkan jika acara yang sudah 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. Defaultnya adalah False.
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
recurringEventId	string	Untuk instance acara berulang, ini adalah id acara berulang yang menjadi induk instance ini. Tidak dapat diubah.
reminders	object	Informasi tentang pengingat acara untuk pengguna terautentikasi. Perhatikan bahwa mengubah pengingat tidak mengubah properti updated dari acara yang melampirkan.
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	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 acara 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 "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
updated	datetime	Waktu modifikasi terakhir data acara utama (sebagai stempel waktu RFC3339). Memperbarui pengingat acara tidak akan mengubahnya. Hanya baca.
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

Metode

hapus

Menghapus acara.

get

Menampilkan acara berdasarkan ID Google Kalendernya. Untuk mengambil acara menggunakan ID iCalendar-nya, panggil metode events.list menggunakan parameter iCalUID.

impor

Mengimpor acara. 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 menjadi default dan properti khusus jenis peristiwa yang mungkin dimilikinya akan dihapus.

insert

Membuat acara.

instances

Menampilkan instance acara berulang yang ditentukan.

list

Menampilkan acara di kalender yang ditentukan.

pindah

Memindahkan acara ke kalender lain, yaitu mengubah penyelenggara acara. Perhatikan bahwa hanya peristiwa default yang dapat dipindahkan; peristiwa birthday, focusTime, fromGmail, outOfOffice, dan workingLocation tidak dapat dipindahkan.

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 tidak akan berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; hal ini akan menghapus elemen array sebelumnya.

quickAdd

Membuat acara berdasarkan string teks sederhana.

update

Memperbarui acara. Metode ini tidak mendukung semantik patch dan selalu mengupdate seluruh resource acara. Untuk melakukan update parsial, lakukan get yang diikuti dengan update menggunakan eTag untuk memastikan atomisitas.

tonton

Pantau perubahan pada resource Acara.