Method: resources.calendars.list
Tetap teratur dengan koleksi
Simpan dan kategorikan konten berdasarkan preferensi Anda.
Mengambil daftar fasilitas kalender untuk akun.
Permintaan HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
URL menggunakan sintaksis gRPC Transcoding.
Parameter jalur
Parameter |
customer |
string
ID unik untuk akun Google Workspace pelanggan. Sebagai administrator akun, Anda juga dapat menggunakan alias my_customer untuk mewakili ID pelanggan akun Anda.
|
Parameter kueri
Parameter |
maxResults |
integer
Jumlah hasil maksimum yang akan ditampilkan.
|
orderBy |
string
Kolom untuk mengurutkan hasil dalam urutan menaik atau menurun. Kolom yang didukung mencakup resourceId , resourceName , capacity , buildingId , dan floorName . Jika tidak ada urutan yang ditentukan, defaultnya adalah menaik. Harus dalam bentuk "kolom [asc|desc], kolom [asc|desc], ...". Misalnya, buildingId,
capacity desc akan menampilkan hasil yang diurutkan terlebih dahulu berdasarkan buildingId dalam urutan menaik, lalu berdasarkan capacity dalam urutan menurun.
|
pageToken |
string
Token untuk menentukan halaman berikutnya dalam daftar.
|
query |
string
Kueri string yang digunakan untuk memfilter hasil. Harus dalam bentuk "nilai operator kolom" dengan kolom dapat berupa salah satu kolom yang didukung dan operator dapat berupa salah satu operasi yang didukung. Operator mencakup '=' untuk pencocokan persis, '!=' untuk ketidakcocokan, dan ':' untuk pencocokan awalan atau pencocokan HAS jika berlaku. Untuk pencocokan awalan, nilai harus selalu diikuti dengan *. Operator logika NOT dan AND didukung (dalam urutan prioritas ini). Kolom yang didukung mencakup generatedResourceName , name , buildingId , floorName , capacity , featureInstances.feature.name , resourceEmail , resourceCategory . Misalnya, buildingId=US-NYC-9TH AND
featureInstances.feature.name:Phone .
|
Isi permintaan
Isi permintaan harus kosong.
Isi respons
API Publik: Resources.calendars
Jika berhasil, isi respons memuat data dengan struktur berikut:
Representasi JSON |
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource )
}
],
"nextPageToken": string
} |
Kolom |
kind |
string
Mengidentifikasinya sebagai kumpulan CalendarResources. Nilai ini selalu admin#directory#resources#calendars#calendarResourcesList .
|
etag |
string
ETag resource.
|
items[] |
object (CalendarResource )
CalendarResources di halaman hasil ini.
|
nextPageToken |
string
Token lanjutan, yang digunakan untuk mengelompokkan kumpulan hasil yang besar. Berikan nilai ini dalam permintaan berikutnya untuk menampilkan halaman hasil berikutnya.
|
Cakupan otorisasi
Memerlukan salah satu cakupan OAuth berikut:
https://apps-apis.google.com/a/feeds/calendar/resource/
https://www.googleapis.com/auth/admin.directory.resource.calendar
https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly
Untuk mengetahui informasi selengkapnya, lihat Panduan otorisasi.
Kecuali dinyatakan lain, konten di halaman ini dilisensikan berdasarkan Lisensi Creative Commons Attribution 4.0, sedangkan contoh kode dilisensikan berdasarkan Lisensi Apache 2.0. Untuk mengetahui informasi selengkapnya, lihat Kebijakan Situs Google Developers. Java adalah merek dagang terdaftar dari Oracle dan/atau afiliasinya.
Terakhir diperbarui pada 2025-07-25 UTC.
[null,null,["Terakhir diperbarui pada 2025-07-25 UTC."],[],[],null,["# Method: resources.calendars.list\n\nRetrieves a list of calendar resources for an account.\n\n### HTTP request\n\n`GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `customer` | `string` The unique ID for the customer's Google Workspace account. As an account administrator, you can also use the `my_customer` alias to represent your account's customer ID. |\n\n### Query parameters\n\n| Parameters ||\n|--------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `maxResults` | `integer` Maximum number of results to return. |\n| `orderBy` | `string` Field(s) to sort results by in either ascending or descending order. Supported fields include `resourceId`, `resourceName`, `capacity`, `buildingId`, and `floorName`. If no order is specified, defaults to ascending. Should be of the form \"field \\[asc\\|desc\\], field \\[asc\\|desc\\], ...\". For example `buildingId, capacity desc` would return results sorted first by `buildingId` in ascending order then by `capacity` in descending order. |\n| `pageToken` | `string` Token to specify the next page in the list. |\n| `query` | `string` String query used to filter results. Should be of the form \"field operator value\" where field can be any of supported fields and operators can be any of supported operations. Operators include '=' for exact match, '!=' for mismatch and ':' for prefix match or HAS match where applicable. For prefix match, the value should always be followed by a \\*. Logical operators NOT and AND are supported (in this order of precedence). Supported fields include `generatedResourceName`, `name`, `buildingId`, `floorName`, `capacity`, `featureInstances.feature.name`, `resourceEmail`, `resourceCategory`. For example `buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone`. |\n\n### Request body\n\nThe request body must be empty.\n\n### Response body\n\nPublic API: Resources.calendars\n\nIf successful, the response body contains data with the following structure:\n\n| JSON representation |\n|----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| ``` { \"kind\": string, \"etag\": string, \"items\": [ { object (/workspace/admin/directory/reference/rest/v1/resources.calendars#CalendarResource) } ], \"nextPageToken\": string } ``` |\n\n| Fields ||\n|-----------------|-------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `kind` | `string` Identifies this as a collection of CalendarResources. This is always `admin#directory#resources#calendars#calendarResourcesList`. |\n| `etag` | `string` ETag of the resource. |\n| `items[]` | `object (`[CalendarResource](/workspace/admin/directory/reference/rest/v1/resources.calendars#CalendarResource)`)` The CalendarResources in this page of results. |\n| `nextPageToken` | `string` The continuation token, used to page through large result sets. Provide this value in a subsequent request to return the next page of results. |\n\n### Authorization scopes\n\nRequires one of the following OAuth scopes:\n\n- `https://apps-apis.google.com/a/feeds/calendar/resource/`\n- `\n https://www.googleapis.com/auth/admin.directory.resource.calendar`\n- `\n https://www.googleapis.com/auth/admin.directory.resource.calendar.readonly`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]