|
계정의 모든 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 상태 코드.