Method: chromeosdevices.list

계정 내에서 페이지로 나눈 Chrome OS 기기 목록을 검색합니다.

HTTP 요청

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/chromeos

URL은 gRPC 트랜스코딩 문법을 사용합니다.

경로 매개변수

매개변수
customerId

string

고객 Google Workspace 계정의 고유 ID입니다. 계정 관리자는 my_customer 별칭을 사용하여 계정의 customerId을 나타낼 수도 있습니다. customerId도 사용자 리소스의 일부로 반환됩니다.

쿼리 매개변수

매개변수
maxResults

integer

반환할 결과의 최대 수입니다. 값은 300 이하여야 합니다.
orderBy

enum (OrderBy)

결과 정렬에 사용할 기기 속성입니다.
orgUnitPath

string

조직 단위의 전체 경로 (선행 / 제외) 또는 고유 ID입니다.
pageToken

string

pageToken 쿼리 매개변수는 쿼리 결과의 다음 페이지를 요청하는 데 사용됩니다. 후속 요청의 pageToken 쿼리 매개변수는 이전 응답의 nextPageToken입니다.
projection

enum (Projection)

응답에 전체 속성 목록을 포함할지 아니면 하위 집합만 포함할지 결정합니다.
query

string

https://developers.google.com/admin-sdk/directory/v1/list-query-operators에 명시된 형식의 검색 문자열
sortOrder

enum (SortOrder)

결과를 오름차순 또는 내림차순으로 반환할지 여부입니다. orderBy 매개변수와 함께 사용해야 합니다.
includeChildOrgunits

boolean

모든 하위 조직 단위 및 지정된 조직 단위에서 기기를 반환합니다. true로 설정하면 'orgUnitPath' 를 입력해야 합니다.

요청 본문

요청 본문은 비어 있어야 합니다.

응답 본문

성공한 경우 응답 본문은 다음과 같은 구조의 데이터를 포함합니다.

JSON 표현 
{
  "kind": string,
  "etag": string,
  "chromeosdevices": [
    {
      object (ChromeOsDevice)
    }
  ],
  "nextPageToken": string
}
필드
kind

string

리소스의 유형입니다.
etag

string

리소스의 eETag입니다.
chromeosdevices[]

object (ChromeOsDevice)

Chrome OS 기기 객체 목록입니다.
nextPageToken

string

이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다. 다음 페이지에 액세스하려면 이 요청의 pageToken 쿼리 문자열에 이 토큰의 값을 사용합니다.

승인 범위

다음 OAuth 범위 중 하나가 필요합니다.

  • https://www.googleapis.com/auth/admin.directory.device.chromeos
  • https://www.googleapis.com/auth/admin.directory.device.chromeos.readonly

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

OrderBy

열거형
ANNOTATED_LOCATION 관리자가 주석 처리한 Chrome 기기 위치입니다.
ANNOTATED_USER 관리자가 주석 처리한 Chromebook 사용자
LAST_SYNC Chrome 기기가 관리 콘솔의 정책 설정과 마지막으로 동기화된 날짜 및 시간입니다.
NOTES 관리자가 주석 처리한 Chrome 기기 메모
SERIAL_NUMBER 기기가 사용 설정되었을 때 입력된 Chrome 기기의 일련번호입니다.
STATUS Chrome 기기 상태입니다. 자세한 내용은 <a chromeosdevices를 참조하세요.

투영

기기에 대해 표시할 투영 유형입니다.

열거형
BASIC 기본 메타데이터 필드 (예: deviceId, serialNumber, status 및 user)만 포함
FULL 모든 메타데이터 필드 포함

SortOrder

기기 목록에 적용되어야 하는 정렬 순서입니다.

열거형
ASCENDING 오름차순
DESCENDING 내림차순입니다.