Method: mobiledevices.list

계정의 모든 사용자 소유 휴대기기의 페이지가 매겨진 목록을 검색합니다. 회사 소유 기기가 포함된 목록을 검색하려면 대신 Cloud ID Devices API를 사용하세요. 이 메서드는 60분 후에 타임아웃됩니다. 자세한 내용은 오류 코드 문제 해결하기를 참고하세요.

HTTP 요청

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

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

경로 매개변수

매개변수
customerId

string

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

쿼리 매개변수

매개변수
maxResults

integer

반환할 결과의 최대 수입니다. 허용되는 최댓값은 100입니다.

orderBy

enum (OrderBy)

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

pageToken

string

목록의 다음 페이지를 지정하는 토큰입니다.

projection

enum (Projection)

반환되는 정보를 선택한 필드 집합으로 제한합니다.

query

string

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

sortOrder

enum (SortOrder)

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

요청 본문

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

응답 본문

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

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

string

리소스의 유형입니다.

etag

string

리소스의 eETag입니다.

mobiledevices[]

object (MobileDevice)

휴대기기 객체의 목록입니다.

nextPageToken

string

이 결과의 다음 페이지에 액세스하는 데 사용되는 토큰입니다.

승인 범위

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

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

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

OrderBy

열거형
DEVICE_ID Google 동기화 휴대기기의 일련번호입니다. Android 기기의 경우 소프트웨어에서 생성된 고유 식별자입니다.
EMAIL 기기 소유자의 이메일 주소입니다.
LAST_SYNC 기기의 마지막 정책 설정 동기화 날짜 시간입니다.
MODEL 휴대기기의 모델입니다.
NAME 기기 소유자의 사용자 이름입니다.
OS 기기의 운영체제
STATUS 기기 상태입니다.
TYPE 기기 유형입니다.

투영

열거형
BASIC 기본 메타데이터 필드 (예: deviceId, 모델, 상태, 유형 및 상태)만 포함
FULL 모든 메타데이터 필드 포함

SortOrder

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