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/workspace/admin/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

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

object (ChromeOsDevice)

ChromeOS 기기 객체 목록입니다.
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 내림차순