Method: resources.calendars.list
Zadbaj o dobrą organizację dzięki kolekcji
Zapisuj i kategoryzuj treści zgodnie ze swoimi preferencjami.
Pobiera listę zasobów kalendarza na koncie.
Żądanie HTTP
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
Adres URL używa składni transkodowania gRPC.
Parametry ścieżki
Parametry |
customer |
string
Unikalny identyfikator konta Google Workspace klienta. Jako administrator konta możesz też użyć aliasu my_customer , aby reprezentować identyfikator klienta Twojego konta.
|
Parametry zapytania
Parametry |
maxResults |
integer
Maksymalna liczba wyników do zwrócenia.
|
orderBy |
string
Pole lub pola, według których chcesz sortować wyniki w kolejności rosnącej lub malejącej. Obsługiwane pola to resourceId , resourceName , capacity , buildingId i floorName . Jeśli nie określisz kolejności, domyślnie zostanie użyta kolejność rosnąca. Powinien mieć format „pole [asc|desc], pole [asc|desc], itd.”. Na przykład buildingId,
capacity desc zwróci wyniki posortowane najpierw według pola buildingId w kolejności rosnącej, a następnie według pola capacity w kolejności malejącej.
|
pageToken |
string
Token do określenia następnej strony na liście.
|
query |
string
Ciąg znaków używany do filtrowania wyników. Powinien mieć format „pole operator wartość”, gdzie pole może być dowolnym obsługiwanym polem, a operator może być dowolną obsługiwaną operacją. Operatory obejmują „=”, aby określić dopasowanie ścisłe, „!=”, aby określić brak dopasowania, oraz „:”, aby określić dopasowanie prefiksu lub HAS (w stosownych przypadkach). W przypadku dopasowania prefiksu wartość powinna być zawsze poprzedzona symbolem *. Obsługiwane są operatory logiczne NIE i I (w tej kolejności pierwszeństwa). Obsługiwane pola to generatedResourceName , name , buildingId , floorName , capacity , featureInstances.feature.name , resourceEmail , resourceCategory . Na przykład buildingId=US-NYC-9TH AND
featureInstances.feature.name:Phone .
|
Treść żądania
Treść żądania musi być pusta.
Treść odpowiedzi
Interfejs publiczny API: Resources.calendars
W przypadku powodzenia treść żądania zawiera dane o następującej strukturze:
Zapis JSON |
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource )
}
],
"nextPageToken": string
} |
Pola |
kind |
string
Określa to jako kolekcję zasobów kalendarza. Jest ona zawsze admin#directory#resources#calendars#calendarResourcesList .
|
etag |
string
ETag zasobu.
|
items[] |
object (CalendarResource )
Zasoby kalendarza na tej stronie wyników.
|
nextPageToken |
string
token kontynuacji, który służy do przewijania dużych zbiorów wyników. Aby pobrać kolejną stronę wyników, podaj tę wartość w koleistycznym żądaniu.
|
Zakresy autoryzacji
Wymaga jednego z tych zakresów OAuth:
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
Więcej informacji znajdziesz w przewodniku dotyczącym autoryzacji.
O ile nie stwierdzono inaczej, treść tej strony jest objęta licencją Creative Commons – uznanie autorstwa 4.0, a fragmenty kodu są dostępne na licencji Apache 2.0. Szczegółowe informacje na ten temat zawierają zasady dotyczące witryny Google Developers. Java jest zastrzeżonym znakiem towarowym firmy Oracle i jej podmiotów stowarzyszonych.
Ostatnia aktualizacja: 2025-07-25 UTC.
[null,null,["Ostatnia aktualizacja: 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)."]]