Freebusy: query

Menampilkan informasi senggang/sibuk untuk sekumpulan kalender. Coba sekarang.

Permintaan

Permintaan HTTP

POST https://www.googleapis.com/calendar/v3/freeBusy

Otorisasi

Permintaan ini memungkinkan otorisasi dengan minimal salah satu cakupan berikut:

Cakupan
https://www.googleapis.com/auth/calendar.readonly
https://www.googleapis.com/auth/calendar
https://www.googleapis.com/auth/calendar.events.freebusy
https://www.googleapis.com/auth/calendar.freebusy

Untuk mengetahui informasi selengkapnya, lihat halaman autentikasi dan otorisasi.

Isi permintaan

Dalam isi permintaan, berikan data dengan struktur berikut:

{
  "timeMin": datetime,
  "timeMax": datetime,
  "timeZone": string,
  "groupExpansionMax": integer,
  "calendarExpansionMax": integer,
  "items": [
    {
      "id": string
    }
  ]
}
Nama properti Nilai Deskripsi Catatan
timeMin datetime Awal interval untuk kueri yang diformat sesuai RFC3339.
timeMax datetime Akhir interval untuk kueri yang diformat sesuai RFC3339.
timeZone string Zona waktu yang digunakan dalam respons. Opsional. Defaultnya adalah UTC.
groupExpansionMax integer Jumlah maksimum ID kalender yang akan diberikan untuk satu grup. Opsional. Error akan ditampilkan untuk grup yang memiliki lebih banyak anggota daripada nilai ini. Nilai maksimumnya adalah 100.
calendarExpansionMax integer Jumlah maksimum kalender yang akan diberi informasi Senggang/Sibuk. Opsional. Nilai maksimumnya adalah 50.
items[] list Daftar kalender dan/atau grup yang akan dikueri.
items[].id string ID kalender atau grup.

Respons

Jika berhasil, metode ini akan menampilkan isi respons dengan struktur berikut:

{
  "kind": "calendar#freeBusy",
  "timeMin": datetime,
  "timeMax": datetime,
  "groups": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "calendars": [
        string
      ]
    }
  },
  "calendars": {
    (key): {
      "errors": [
        {
          "domain": string,
          "reason": string
        }
      ],
      "busy": [
        {
          "start": datetime,
          "end": datetime
        }
      ]
    }
  }
}
Nama properti Nilai Deskripsi Catatan
kind string Jenis resource ("calendar#freeBusy").
timeMin datetime Awal interval.
timeMax datetime Akhir interval.
groups object Perluasan grup.
groups.(key) nested object Daftar kalender yang merupakan anggota grup ini.
groups.(key).errors[] list Error opsional (jika komputasi untuk grup gagal).
groups.(key).errors[].domain string Domain, atau kategori luas, error.
groups.(key).errors[].reason string Alasan spesifik terjadinya error. Beberapa kemungkinan nilainya adalah:
  • "groupTooBig" - Grup pengguna yang diminta terlalu besar untuk satu kueri.
  • "tooManyCalendarsRequested" - Jumlah kalender yang diminta terlalu besar untuk satu kueri.
  • "notFound" - Resource yang diminta tidak ditemukan.
  • "internalError" - Layanan API mengalami error internal.
Jenis error tambahan dapat ditambahkan pada masa mendatang, sehingga klien harus menangani status error tambahan yang tidak disertakan dalam daftar ini dengan baik.
groups.(key).calendars[] list Daftar ID kalender dalam grup.
calendars object Daftar informasi senggang/sibuk untuk kalender.
calendars.(key) nested object Perluasan senggang/sibuk untuk satu kalender.
calendars.(key).errors[] list Error opsional (jika komputasi untuk kalender gagal).
calendars.(key).errors[].domain string Domain, atau kategori luas, error.
calendars.(key).errors[].reason string Alasan spesifik terjadinya error. Beberapa kemungkinan nilainya adalah:
  • "groupTooBig" - Grup pengguna yang diminta terlalu besar untuk satu kueri.
  • "tooManyCalendarsRequested" - Jumlah kalender yang diminta terlalu besar untuk satu kueri.
  • "notFound" - Resource yang diminta tidak ditemukan.
  • "internalError" - Layanan API mengalami error internal.
Jenis error tambahan dapat ditambahkan pada masa mendatang, sehingga klien harus menangani status error tambahan yang tidak disertakan dalam daftar ini dengan baik.
calendars.(key).busy[] list Daftar rentang waktu saat kalender ini dianggap sibuk.
calendars.(key).busy[].start datetime Awal (inklusif) jangka waktu.
calendars.(key).busy[].end datetime Akhir (eksklusif) jangka waktu.

Cobalah!

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