CalendarList

Koleksi kalender dalam daftar kalender pengguna. Lihat juga Kalender vs CalendarList.

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

Representasi resource

{
  "kind": "calendar#calendarListEntry",
  "etag": etag,
  "id": string,
  "summary": string,
  "description": string,
  "location": string,
  "timeZone": string,
  "summaryOverride": string,
  "colorId": string,
  "backgroundColor": string,
  "foregroundColor": string,
  "hidden": boolean,
  "selected": boolean,
  "accessRole": string,
  "defaultReminders": [
    {
      "method": string,
      "minutes": integer
    }
  ],
  "notificationSettings": {
    "notifications": [
      {
        "type": string,
        "method": string
      }
    ]
  },
  "primary": boolean,
  "deleted": boolean,
  "conferenceProperties": {
    "allowedConferenceSolutionTypes": [
      string
    ]
  }
}

Nama properti	Nilai	Deskripsi	Catatan
accessRole	string	Peran akses efektif yang dimiliki pengguna terautentikasi di kalender. Hanya baca. Kemungkinan nilainya adalah: "freeBusyReader" - Menyediakan akses baca ke informasi senggang/sibuk. "reader" - Menyediakan akses baca ke kalender. Acara pribadi akan muncul untuk pengguna yang memiliki akses pembaca, tetapi detail acara akan disembunyikan. "writer" - Memberikan akses baca dan tulis ke kalender. Acara pribadi akan muncul untuk pengguna yang memiliki akses penulis, dan detail acara akan terlihat. "owner" - Memberikan kepemilikan kalender. Peran ini memiliki semua izin peran penulis dengan kemampuan tambahan untuk melihat dan memanipulasi ACL.
backgroundColor	string	Warna utama kalender dalam format heksadesimal "#0088aa". Properti ini menggantikan properti colorId berbasis indeks. Untuk menetapkan atau mengubah properti ini, Anda harus menentukan colorRgbFormat=true dalam parameter metode insert, update, dan patch. Opsional.	dapat ditulis
colorId	string	Warna kalender. Ini adalah ID yang merujuk ke entri di bagian calendar dari definisi warna (lihat endpoint warna). Properti ini digantikan oleh properti backgroundColor dan foregroundColor serta dapat diabaikan saat menggunakan properti ini. Opsional.	dapat ditulis
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.
defaultReminders[]	list	Pengingat default yang dimiliki pengguna terautentikasi untuk kalender ini.	dapat ditulis
defaultReminders[].method	string	Metode yang digunakan oleh pengingat ini. Kemungkinan nilainya adalah: "email" - Pengingat akan dikirim melalui email. "popup" - Pengingat dikirim melalui pop-up UI. Wajib diisi saat menambahkan pengingat.	dapat ditulis
defaultReminders[].minutes	integer	Jumlah menit sebelum acara dimulai saat pengingat akan dipicu. Nilai yang valid adalah antara 0 dan 40320 (4 minggu dalam menit). Wajib diisi saat menambahkan pengingat.	dapat ditulis
deleted	boolean	Apakah entri daftar kalender ini telah dihapus dari daftar kalender. Hanya baca. Opsional. Defaultnya adalah Salah.
description	string	Deskripsi kalender. Opsional. Hanya baca.
etag	etag	ETag resource.
foregroundColor	string	Warna latar depan kalender dalam format heksadesimal "#ffffff". Properti ini menggantikan properti colorId berbasis indeks. Untuk menetapkan atau mengubah properti ini, Anda harus menentukan colorRgbFormat=true dalam parameter metode insert, update, dan patch. Opsional.	dapat ditulis
hidden	boolean	Apakah kalender disembunyikan dari daftar. Opsional. Atribut hanya ditampilkan saat kalender disembunyikan, dalam hal ini nilainya adalah true.	dapat ditulis
id	string	ID kalender.
kind	string	Jenis fasilitas ("calendar#calendarListEntry").
location	string	Lokasi geografis kalender sebagai teks bentuk bebas. Opsional. Hanya baca.
notificationSettings	object	Notifikasi yang diterima pengguna terautentikasi untuk kalender ini.	dapat ditulis
notificationSettings.notifications[]	list	Daftar notifikasi yang ditetapkan untuk kalender ini.
notificationSettings.notifications[].method	string	Metode yang digunakan untuk mengirimkan notifikasi. Nilai yang mungkin adalah: "email" - Notifikasi dikirim melalui email. Diperlukan saat menambahkan notifikasi.	dapat ditulis
notificationSettings.notifications[].type	string	Jenis notifikasi. Kemungkinan nilainya adalah: "eventCreation" - Notifikasi yang dikirim saat ada acara baru di kalender. "eventChange" - Notifikasi yang dikirim saat acara diubah. "eventCancellation" - Notifikasi yang dikirim saat acara dibatalkan. "eventResponse" - Notifikasi yang dikirim saat tamu menanggapi undangan acara. "agenda" - Agenda dengan acara hari itu (dikirim di pagi hari). Diperlukan saat menambahkan notifikasi.	dapat ditulis
primary	boolean	Apakah kalender adalah kalender utama pengguna yang diautentikasi. Hanya baca. Opsional. Defaultnya adalah Salah.
selected	boolean	Apakah konten kalender muncul di UI kalender. Opsional. Defaultnya adalah Salah.	dapat ditulis
summary	string	Judul kalender. Hanya baca.
summaryOverride	string	Ringkasan yang ditetapkan pengguna terautentikasi untuk kalender ini. Opsional.	dapat ditulis
timeZone	string	Zona waktu kalender. Opsional. Hanya baca.

Metode

hapus

Menghapus kalender dari daftar kalender pengguna.

dapatkan

Menampilkan kalender dari daftar kalender pengguna.

sisipkan

Menyisipkan kalender yang sudah ada ke daftar kalender pengguna.

list

Menampilkan kalender di daftar kalender pengguna.

patch

Memperbarui kalender yang sudah ada di daftar kalender pengguna. Metode ini mendukung semantik patch. Perlu diperhatikan bahwa setiap permintaan patch menggunakan tiga unit kuota; lebih suka menggunakan get 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; ini akan membuang elemen {i>array<i} sebelumnya.

info terbaru

Memperbarui kalender yang sudah ada di daftar kalender pengguna.

jam tangan

Perhatikan perubahan pada fasilitas CalendarList.