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

자세한 내용은 승인 가이드를 참고하세요.