계정의 모든 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를 사용하여 특정 사용자를 검색합니다. 응답에는 annotatedUser이 help desk인 단일 chromeosdevice 리소스가 포함되어 있습니다.
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)입니다. 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 상태 코드가 반환됩니다.