Calendars

Kumpulan semua kalender yang ada. Lihat juga Calendars vs CalendarList.

Untuk mengetahui daftar metode untuk resource ini, lihat bagian akhir halaman ini.

Representasi resource

{
  "kind": "calendar#calendar",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "dataOwner": string,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  },
  "autoAcceptInvitations": boolean
}
Nama properti Nilai Deskripsi Catatan
autoAcceptInvitations boolean Apakah kalender ini otomatis menyetujui undangan. Hanya valid untuk kalender resource.
conferenceProperties nested object Properti konferensi untuk kalender ini, misalnya jenis konferensi yang diizinkan.
conferenceProperties.allowedConferenceSolutionTypes[] list Jenis solusi konferensi yang didukung untuk kalender ini.

Kemungkinan nilainya adalah:

  • "eventHangout"
  • "eventNamedHangout"
  • "hangoutsMeet"
Opsional.
dataOwner string Email pemilik kalender. Disetel hanya untuk kalender sekunder. Hanya baca.
description string Deskripsi kalender. Opsional. dapat ditulis
etag etag ETag resource.
id string ID kalender. Untuk mengambil ID, panggil metode calendarList.list().
kind string Jenis resource ("calendar#calendar").
location string Lokasi geografis kalender sebagai teks bentuk bebas. Opsional. dapat ditulis
summary string Judul kalender. dapat ditulis
timeZone string Zona waktu kalender. (Diformat sebagai nama Database Zona Waktu IANA, misalnya "Europe/Zurich".) Opsional. dapat ditulis

Metode

hapus
Menghapus kalender utama. Operasi ini menghapus semua acara yang terkait dengan kalender utama akun.
hapus
Menghapus kalender sekunder. Gunakan calendars.clear untuk menghapus semua acara di kalender utama.
get
Menampilkan metadata untuk kalender.
insert
Membuat kalender sekunder.

Pengguna terautentikasi untuk permintaan tersebut akan menjadi pemilik data kalender baru.

patch
Memperbarui metadata untuk kalender. 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 tetap tidak berubah. Kolom array, jika ditentukan, akan menimpa array yang ada; hal ini akan menghapus elemen array sebelumnya.
transferOwnership
Mentransfer kalender sekunder antarpengguna dalam organisasi Google Workspace. Memerlukan autentikasi pengguna dengan hak istimewa administrator Mengelola Kalender, dan salah satu cakupan otorisasi berikut:
  • https://www.googleapis.com/auth/calendar
  • https://www.googleapis.com/auth/calendar.calendars
Dalam permintaan, tetapkan useAdminAccess ke true. Kalender sekunder harus aktif agar dapat ditransfer. Transfer kalender yang dinonaktifkan atau dihapus tidak didukung.
update
Memperbarui metadata untuk kalender.