계정의 모든 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 계정의 고유 식별자입니다.- 계정 관리자는 계정의
customerId를 나타내는my_customer문자열을 사용할 수도 있습니다.customerId값을 가져오는 또 다른 방법은 사용자 검색 작업을 사용하는 것입니다. 작업의userKey경로 매개변수에 관리자 이메일 주소 또는 관리자 순 사용자id값을 사용합니다.
쿼리 문자열, 요청, 응답 속성에 대해서는 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는 Chrome 기기의 3G 모바일 카드에 관한 MEID (Mobile Equipment Identifier)입니다. 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 계정의 고유 식별자입니다.- 계정 관리자는 계정의
customerId를 나타내는my_customer문자열을 사용할 수도 있습니다.customerId값을 가져오는 또 다른 방법은 사용자 검색 작업을 사용하는 것입니다. 작업의userKey경로 매개변수에 관리자 이메일 주소 또는 관리자 순 사용자id값을 사용합니다. 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 계정의 고유 식별자입니다.- 계정 관리자는 계정의
customerId를 나타내는my_customer문자열을 사용할 수도 있습니다.customerId값을 가져오는 또 다른 방법은 사용자 검색 작업을 사용하는 것입니다. 작업의userKey경로 매개변수에 관리자 이메일 주소 또는 관리자 순 사용자id값을 사용합니다. 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 계정의 고유 식별자입니다.- 계정 관리자는 계정의
customerId를 나타내는my_customer문자열을 사용할 수도 있습니다.customerId값을 가져오는 또 다른 방법은 사용자 검색 작업을 사용하는 것입니다. 작업의userKey경로 매개변수에 관리자 이메일 주소 또는 관리자 순 사용자id값을 사용합니다.
요청 및 응답 속성은 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"
}
사용 중지 요청 본문:
{
"deviceIds": ["deviceId_1", "deviceId_2", "deviceId_3"],
"changeChromeOsDeviceStatusAction": "CHANGE_CHROME_OS_DEVICE_STATUS_ACTION_DISABLE",
}
요청이 성공하면 HTTP 200 상태 코드가 반환됩니다.
조직 단위로 Chrome 기기 이동
조직 단위로 최대 50대의 Chrome 기기를 이동하려면 다음 POST 요청을 사용하여 요청 승인에 설명된 승인을 포함합니다. 가독성을 위해 이 코드 샘플에는 다음과 같은 라인 반환이 있습니다.
POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/ devices/chromeos/moveDevicesToOu?orgUnitPath=/SomeOuName
customerId는 고객 Google 계정의 고유 식별자입니다.- 계정 관리자는 계정의
customerId를 나타내는my_customer문자열을 사용할 수도 있습니다.customerId값을 가져오는 또 다른 방법은 사용자 검색 작업을 사용하는 것입니다. 작업의userKey경로 매개변수에 관리자 이메일 주소 또는 관리자 순 사용자id값을 사용합니다.
요청 및 응답 속성은 API 참조를 확인하세요.
JSON 요청
다음 JSON 요청은 Chrome 기기 3대를 /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 상태 코드가 반환됩니다.