Method: resources.calendars.list
Оптимизируйте свои подборки
Сохраняйте и классифицируйте контент в соответствии со своими настройками.
Получает список ресурсов календаря для учетной записи.
HTTP-запрос
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
customer | string Уникальный идентификатор аккаунта Google Workspace клиента. Как администратор учетной записи вы также можете использовать псевдоним my_customer для обозначения идентификатора клиента вашей учетной записи. |
Параметры запроса
Параметры |
---|
maxResults | integer Максимальное количество возвращаемых результатов. |
orderBy | string Поля(я) для сортировки результатов по возрастанию или убыванию. Поддерживаемые поля включают resourceId , resourceName , capacity , buildingId и floorName . Если порядок не указан, по умолчанию используется возрастающий. Должно иметь вид «поле [по возрастанию|убыванию], поле [по возрастанию|убыванию], ...». Например buildingId, capacity desc будут возвращать результаты, отсортированные сначала по buildingId в порядке возрастания, а затем по capacity в порядке убывания. |
pageToken | string Токен для указания следующей страницы в списке. |
query | string Строковый запрос, используемый для фильтрации результатов. Должно иметь форму «значение оператора поля», где поле может быть любым из поддерживаемых полей, а операторы — любой из поддерживаемых операций. Операторы включают «=» для точного соответствия, «!=» для несоответствия и «:» для совпадения префикса или совпадения HAS, где это применимо. Для соответствия префикса за значением всегда должен следовать *. Поддерживаются логические операторы НЕ и И (в указанном порядке). Поддерживаемые поля включают generatedResourceName , name , buildingId , floorName , capacity , featureInstances.feature.name , resourceEmail , resourceCategory . Например buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone . |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Публичный API: Resources.calendars
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource )
}
],
"nextPageToken": string
} |
Поля |
---|
kind | string Идентифицирует это как коллекцию CalendarResources. Это всегда admin#directory#resources#calendars#calendarResourcesList . |
etag | string ETag ресурса. |
items[] | object ( CalendarResource ) CalendarResources на этой странице результатов. |
nextPageToken | string Токен продолжения, используемый для постраничного просмотра больших наборов результатов. Укажите это значение в последующем запросе, чтобы вернуть следующую страницу результатов. |
Области авторизации
Требуется одна из следующих областей 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
Дополнительную информацию см. в руководстве по авторизации .
,
Получает список ресурсов календаря для учетной записи.
HTTP-запрос
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
URL-адрес использует синтаксис транскодирования gRPC .
Параметры пути
Параметры |
---|
customer | string Уникальный идентификатор аккаунта Google Workspace клиента. Как администратор учетной записи вы также можете использовать псевдоним my_customer для обозначения идентификатора клиента вашей учетной записи. |
Параметры запроса
Параметры |
---|
maxResults | integer Максимальное количество возвращаемых результатов. |
orderBy | string Поля(я) для сортировки результатов по возрастанию или убыванию. Поддерживаемые поля включают resourceId , resourceName , capacity , buildingId и floorName . Если порядок не указан, по умолчанию используется возрастающий. Должно иметь вид «поле [по возрастанию|убыванию], поле [по возрастанию|убыванию], ...». Например buildingId, capacity desc будут возвращать результаты, отсортированные сначала по buildingId в порядке возрастания, а затем по capacity в порядке убывания. |
pageToken | string Токен для указания следующей страницы в списке. |
query | string Строковый запрос, используемый для фильтрации результатов. Должно иметь форму «значение оператора поля», где поле может быть любым из поддерживаемых полей, а операторы — любой из поддерживаемых операций. Операторы включают «=» для точного соответствия, «!=» для несоответствия и «:» для совпадения префикса или совпадения HAS, где это применимо. Для соответствия префикса за значением всегда должен следовать *. Поддерживаются логические операторы НЕ и И (в указанном порядке приоритета). Поддерживаемые поля включают generatedResourceName , name , buildingId , floorName , capacity , featureInstances.feature.name , resourceEmail , resourceCategory . Например buildingId=US-NYC-9TH AND featureInstances.feature.name:Phone . |
Тело запроса
Тело запроса должно быть пустым.
Тело ответа
Публичный API: Resources.calendars
В случае успеха тело ответа содержит данные следующей структуры:
JSON-представление |
---|
{
"kind": string,
"etag": string,
"items": [
{
object (CalendarResource )
}
],
"nextPageToken": string
} |
Поля |
---|
kind | string Идентифицирует это как коллекцию CalendarResources. Это всегда admin#directory#resources#calendars#calendarResourcesList . |
etag | string ETag ресурса. |
items[] | object ( CalendarResource ) CalendarResources на этой странице результатов. |
nextPageToken | string Токен продолжения, используемый для постраничного просмотра больших наборов результатов. Укажите это значение в последующем запросе, чтобы вернуть следующую страницу результатов. |
Области авторизации
Требуется одна из следующих областей 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
Дополнительную информацию см. в руководстве по авторизации .
Если не указано иное, контент на этой странице предоставляется по лицензии Creative Commons "С указанием авторства 4.0", а примеры кода – по лицензии Apache 2.0. Подробнее об этом написано в правилах сайта. Java – это зарегистрированный товарный знак корпорации Oracle и ее аффилированных лиц.
Последнее обновление: 2025-07-25 UTC.
[null,null,["Последнее обновление: 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)."]]