Method: resources.calendars.list
컬렉션을 사용해 정리하기
내 환경설정을 기준으로 콘텐츠를 저장하고 분류하세요.
HTTP 요청
GET https://admin.googleapis.com/admin/directory/v1/customer/{customer}/resources/calendars
URL은 gRPC 트랜스코딩 문법을 사용합니다.
경로 매개변수
매개변수 |
customer |
string
고객의 Google Workspace 계정의 고유 ID입니다. 계정 관리자는 my_customer 별칭을 사용하여 계정의 고객 ID를 나타낼 수도 있습니다.
|
쿼리 매개변수
매개변수 |
maxResults |
integer
반환할 결과의 최대 수입니다.
|
orderBy |
string
결과를 오름차순 또는 내림차순으로 정렬할 필드입니다. 지원되는 필드에는 resourceId , resourceName , capacity , buildingId , floorName 가 있습니다. 순서가 지정되지 않은 경우 기본값은 오름차순입니다. '필드 [asc|desc], 필드 [asc|desc], ...' 형식이어야 합니다. 예를 들어 buildingId,
capacity desc 는 먼저 buildingId 를 기준으로 오름차순으로 정렬한 다음 capacity 를 기준으로 내림차순으로 정렬된 결과를 반환합니다.
|
pageToken |
string
목록의 다음 페이지를 지정하는 토큰입니다.
|
query |
string
결과를 필터링하는 데 사용되는 문자열 쿼리입니다. '필드 연산자 값' 형식이어야 하며, 여기서 필드는 지원되는 필드 중 하나가 될 수 있고 연산자는 지원되는 연산 중 하나가 될 수 있습니다. 연산자에는 일치검색의 경우 '=', 일치하지 않는 경우 '!=', 프리픽스 일치 또는 HAS 일치의 경우 ':'가 포함됩니다(해당하는 경우). 접두사 일치의 경우 값 뒤에 항상 *이 따라와야 합니다. NOT 및 AND 논리 연산자가 지원되며 우선순위는 이 순서입니다. 지원되는 필드는 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 Attribution 4.0 라이선스에 따라 라이선스가 부여되며, 코드 샘플에는 Apache 2.0 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 Google Developers 사이트 정책을 참조하세요. 자바는 Oracle 및/또는 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)."]]