Directory API: Chrome 기기

를 통해 개인정보처리방침을 정의할 수 있습니다.

계정의 모든 Chrome 기기 가져오기

계정에 할당된 모든 Chrome 기기 목록을 반환하려면 다음 코드를 사용하세요. GET 요청에 다음 문서에 설명된 승인을 포함합니다. 요청을 승인합니다. 가독성을 위해 이 코드 샘플에는 줄 반환이 있습니다. 

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

  • customerId는 고객 Google 계정의 고유 식별자입니다.
  • 계정 관리자는 my_customer 문자열을 사용할 수도 있습니다. 계정의 customerId을 나타냅니다. customerId을(를) 다운로드하는 다른 방법 값은 사용자 검색 연산으로 해석됩니다. 관리자 이메일 주소 또는 관리자 순 사용자(id)를 사용하세요. 작업의 userKey 경로 매개변수에 있는 값

쿼리 문자열, 요청, 응답 속성은 API 참조

예: 사용자로 기기 필터링

이 예시에서는 query=user:help desk를 사용하여 특정 사용자를 검색합니다. 이 응답에는 단일 chromeosdevice 리소스가 포함됩니다. 여기서 annotatedUser가 help desk입니다.

JSON 요청

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=user:help desk&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON 응답

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "etag": "1234567890"
       "deviceId": "def456",
       "serialNumber": "234567",
       "status": "ACTIVE",
       "lastSync": "2013-03-05T17:30:04.325Z",
       "supportEndDate": "2014-04-05T17:30:04.325Z",
       "annotatedUser": "help desk",
       "annotatedLocation": "Mountain View help desk Chromebook",
       "annotatedAssetId": "1234567890",
       "notes": "Loaned from support",
       "orderNumber": "1234",
       "willAutoRenew": true,
       "osVersion": "Browser Version 18.0",
       "platformVersion": "Platform Version 1415.2.0",
       "firmwareVersion": "Firmware Version 1.2.3.4",
       "bootMode": "validated",
       "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
       "orgUnitPath": "corp/engineering",
       "recentUsers": [
         {
           "type": "USER_TYPE_MANAGED",
           "email": "user@customer.com"
         }
       ],
       "activeTimeRanges": [
         {
           "date": "2012-04-05",
           "activeTime": "3600000"
         }
       ],
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

예: 일련번호로 기기 필터링

이 예시에서는 query=id:123456, 여기서 123456는 기기의 일련번호입니다. 아래에 표시된 응답에는 일치하는 단일 답장이 포함되어 있습니다. 여기서 serialNumber 속성이 검색 값과 일치합니다.

JSON 요청

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos?projection=FULL&query=id:123456&orderBy=status
&sortOrder=ASCENDING&maxResults=100

JSON 응답

{
  "kind": "directory#chromeosdevices",
  "chromeosdevices": [
     {
       "kind": "directory#chromeosdevice",
       "deviceId": "abc123",
       "serialNumber": "123456",
       "status": "SHIPPED",
       "supportEndDate": "1404457200000",
       "model": "model_value",
       "meid": "meid_value",
       "macAddress": "mac_address_value",
       "orderNumber": "1234",
       "willAutoRenew": true
     }
  ],
  "nextPageToken": "abcdefghijkl123"
}

이 응답 예시에는 model, meid, macAddress 속성 기기에 이러한 속성이 없으면 포함되어 있습니다. 자세한 내용은 Chromeosdevices 리소스 표현.

MEID 목록 내보내기

meid는 3G 모바일 카드의 MEID (Mobile Equipment Identifier)입니다. Chrome 기기 MEID는 일반적으로 기기를 무선 통신사의 네트워크에 추가할 때 후불 서비스 요금제를 사용하는 것이 좋습니다 MEID 목록을 내보내려면 다음 GET 요청을 사용합니다. nextPageToken 값을 사용하여 MEID의 전체 목록을 가져옵니다. 가독성을 위해 이 코드 샘플에 줄 반환이 있습니다. 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos?fields=nextPageToken,chromeosdevices(meid)

Chrome 기기 가져오기

Chrome 기기의 속성을 가져오려면 다음 GET 요청을 사용하고 다음 페이지에 설명된 승인을 포함합니다. 요청을 승인합니다. 가독성을 위해 이 코드 샘플에는 줄 반환이 있습니다. 

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId는 고객 Google 계정의 고유 식별자입니다.
  • 계정 관리자는 my_customer 문자열을 사용할 수도 있습니다. 계정의 customerId을 나타냅니다. customerId을(를) 다운로드하는 다른 방법 값은 사용자 검색 연산으로 해석됩니다. 관리자 이메일 주소 또는 관리자 순 사용자(id)를 사용하세요. 작업의 userKey 경로 매개변수에 있는 값
  • deviceId는 기기의 고유 식별자이며 모든 Chrome 기기 검색 작업

쿼리 문자열, 요청, 응답 속성은 API 참조

JSON 요청

요청 예 가독성을 위해 이 코드 샘플에는 줄바꿈이 있습니다. 
GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
chromeos/deviceId?projection=full

JSON 응답

요청에 성공하면 HTTP 200 상태 코드. 또한 상태 코드가 반환되면 응답에서 Chrome 기기 속성을 반환합니다. 

{
  "kind": "directory#chromeosdevice",
  "deviceId": "device_id_value",
  "serialNumber": "device_serial_number",
  "status": "ACTIVE",
  "lastSync": "2012-04-05T17:30:04.325Z",
  "supportEndDate": "2014-04-05T17:30:04.325Z",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "12345667890",
  "notes": "Loaned from support",
  "orderNumber": "123456",
  "willAutoRenew": true,
  "osVersion": "Browser Version 18.0",
  "platformVersion": "Platform Version 1415.2.0",
  "firmwareVersion": "Firmware Version 1.2.3.4",
  "bootMode": "validated"
  "lastEnrollmentTime": "2012-04-05T17:30:04.325Z",
  "orgUnitPath": "corp/engineering"
}

Chrome 기기 업데이트

Chrome 기기를 업데이트하려면 다음 PUT 요청을 사용하고 승인에 설명되어 있습니다. 요청을 승인합니다. 가독성을 위해 이 코드 샘플에는 줄 반환이 있습니다. 

PUT https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}/
devices/chromeos/deviceId?projection={FULL|BASIC}
  • customerId는 고객 Google 계정의 고유 식별자입니다.
  • 계정 관리자는 my_customer 문자열을 사용할 수도 있습니다. 계정의 customerId을 나타냅니다. customerId을(를) 다운로드하는 다른 방법 값은 사용자 검색 연산으로 해석됩니다. 관리자 이메일 주소 또는 관리자 순 사용자(id)를 사용하세요. 작업의 userKey 경로 매개변수에 있는 값
  • deviceId는 기기의 고유 식별자이며 모든 Chrome 기기 검색 작업

쿼리 문자열, 요청, 응답 속성은 API 참조

JSON 요청

다음 JSON 요청 예에서는 Chrome 기기의 annotatedUser를 업데이트합니다. annotatedLocation, annotatedAssetId, notes 외 orgUnitPath 속성 가독성을 위해 이 코드 샘플에는 줄바꿈이 있습니다. 

PUT https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/deviceId?projection=full
요청 본문 예: 
{
  "deviceId": "device_id_value",
  "annotatedUser": "help desk",
  "annotatedLocation": "Mountain View help desk Chromebook",
  "annotatedAssetId": "1234567890",
  "notes": "Loaned from support",
  "orgUnitPath": "/corp/sales"
}

업데이트 요청의 경우 업데이트된 값이 있는 속성만 요청에 포함합니다.

요청에 성공하면 HTTP 200 상태 코드. 또한 상태 코드가 반환되면 응답이 업데이트된 Chrome 기기의 속성을 반환합니다.

Chrome 기기 프로비저닝 해제 또는 사용 중지

Chrome 기기의 프로비저닝을 해제하거나 사용 중지하려면 다음 POST 요청을 사용하세요. 그리고 다음 페이지에 설명된 승인을 포함해야 합니다. 요청을 승인합니다. 가독성을 위해 이 코드 샘플에는 줄 반환이 있습니다. 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer or customerId/
devices/chromeos:batchChangeStatus

  • customerId는 고객 Google 계정의 고유 식별자입니다.
  • 계정 관리자는 my_customer 문자열을 사용할 수도 있습니다. 계정의 customerId을 나타냅니다. customerId을(를) 다운로드하는 다른 방법 값은 사용자 검색 연산으로 해석됩니다. 관리자 이메일 주소 또는 관리자 순 사용자(id)를 사용하세요. 작업의 userKey 경로 매개변수에 있는 값

요청 및 응답 속성은 API 참조

JSON 요청

다음 JSON 요청은 프로비저닝 해제 및 사용 중지 샘플 요청을 보여줍니다. Chrome 기기: 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos:batchChangeStatus
샘플 프로비저닝 해제 요청 본문은 다음과 같습니다. 
{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
  "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DEPROVISION",
  "deprovisionReason": "DEPROVISION_REASON_RETIRING_DEVICE"
}
사용 중지 요청 본문은 다음과 같습니다. <ph type="x-smartling-placeholder">
  {
    "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
    "changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
  }
</ph>

요청에 성공하면 HTTP 200 상태 코드.

조직 단위로 Chrome 기기 이동

최대 50대의 Chrome 기기를 조직 단위로 이동하려면 다음 안내를 따르세요. POST 요청에 다음 문서에 설명된 승인을 포함합니다. 요청을 승인합니다. 가독성을 위해 이 코드 샘플에는 줄 반환이 있습니다. 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
  • customerId는 고객 Google 계정의 고유 식별자입니다.
  • 계정 관리자는 my_customer 문자열을 사용할 수도 있습니다. 계정의 customerId을 나타냅니다. customerId을(를) 다운로드하는 다른 방법 값은 user 작업이 포함됩니다. 관리자 이메일 주소 또는 관리자 고유 사용자 사용 작업의 userKey 경로 매개변수에 있는 id 값

요청 및 응답 속성은 API 참조

JSON 요청

다음 JSON 요청은 3개의 Chrome 기기를 조직 단위(이름: /Marketing): 

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/
devices/chromeos/chromeos/moveDevicesToOu?orgUnitPath=/Marketing

기기 이동의 요청 본문은 다음과 같습니다.

{
  "deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"]
}

요청에 성공하면 HTTP 200 상태 코드.