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

반환할 결과의 최대 수입니다.
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

리소스의 ETag입니다.
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 내림차순입니다.