Directory API: 휴대기기

Google Workspace Directory API를 사용하면 조직 내에서 모바일 기기를 관리할 수 있습니다. 이 페이지에는 휴대기기를 나열하고, 특정 기기의 세부정보를 가져오고, 기기를 추가하거나 삭제하는 방법의 예가 포함되어 있습니다.

이 문서에서는 기본 요건을 성공적으로 완료했다고 가정합니다. Android 기기에는 기기 정책 앱이 설치되어 있어야 합니다. iOS 기기는 Google 모바일 관리 서비스에 등록되어 있어야 합니다.

이 예시에서는 customerId 및 resourceId 자리표시자를 사용하여 이러한 ID를 제공하는 위치를 나타냅니다. customerId는 Users.get 메서드에서 가져올 수 있습니다. resourceId는 기기의 고유한 Google 식별자이며 모든 휴대기기 가져오기 메서드의 응답에서 찾을 수 있습니다.

모든 휴대기기 가져오기

계정의 모든 휴대기기를 가져오려면 다음 GET 요청을 사용하고 승인 요청에 설명된 승인을 포함합니다. 가독성을 위해 이 예시에는 줄바꿈이 포함되어 있습니다. 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile?projection={BASIC|FULL}&query=query
  &orderBy=orderBy category&sortOrder={ASCENDING|DESCENDING}
  &pageToken=token for next results page
  &maxResults=max number of results per page

요청 및 응답 속성은 API 참조를 확인하세요.

JSON 응답

{
   "kind": "directory#mobiledevices",
   "mobiledevices": [
    {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Sales"
     ],
     "email": [
      "sales@example.com"
     ],
     "model": "Nexus 4",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "1234567890",
     "firstSync": "2013-05-15T17:30:04.325Z",
     "lastSync": "2013-06-05T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
   },
   {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Liz"
     ],
     "email": [
      "liz@example.com"
     ],
     "model": "Galaxy Nexus",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "9123456780",
     "firstSync": "2013-06-05T17:30:04.325Z",
     "lastSync": "2013-08-12T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
    }
   ],
   "nextPageToken": "next_page_token_value"
  }

휴대기기 가져오기

휴대기기의 속성을 가져오려면 다음 GET 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. 가독성을 위해 이 예시에는 줄바꿈이 포함되어 있습니다. 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

요청 및 응답 속성은 API 참조를 확인하세요.

JSON 요청

resourceId 요청의 예는 다음과 같습니다. 

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

JSON 응답

{
   "kind": "directory#mobiledevice",
   "resourceId": "resourceId",
   "deviceId": "deviceId",
   "name": [
    "Sales3"
   ],
   "email": [
    "sales@example.com"
   ],
   "model": "Nexus 4",
   "os": "Android 4.2.2",
   "type": "ANDROID",
   "status": "APPROVED",
   "hardwareId": "1234567890",
   "firstSync": "2010-05-15T17:30:04.325Z",
   "lastSync": "2013-06-05T17:30:04.325Z",
   "userAgent": "Google Apps Device Policy 4.14",
  }

휴대기기 승인

휴대기기를 승인하려면 다음 POST 요청을 사용하고 요청 승인에 설명된 승인을 포함합니다. 가독성을 위해 이 예시에는 줄바꿈이 포함되어 있습니다. 

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

요청 및 응답 속성은 API 참조를 확인하세요.

JSON 요청

다음 JSON 요청은 기기를 승인하는 샘플 요청을 보여줍니다. 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

요청 본문은 다음과 같습니다.

{
    "action": "approve"
}

요청이 성공하면 HTTP 200 상태 코드가 반환됩니다.

휴대기기 삭제

휴대기기를 삭제하려면 다음 DELETE 요청을 사용하고 승인 요청에 설명된 승인을 포함합니다. 가독성을 위해 이 예시에는 줄바꿈이 포함되어 있습니다. 

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

요청 및 응답 속성은 API 참조를 확인하세요.

요청이 성공하면 HTTP 200 상태 코드가 반환됩니다.