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

자세한 내용은 OAuth 2.0 개요를 참고하세요.

OrderBy

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

투영

기기에 표시할 프로젝션의 유형입니다.

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

SortOrder

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

열거형
ASCENDING 오름차순
DESCENDING 내림차순