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 내림차순입니다.