本頁面由 Cloud Translation API 翻譯而成。

Directory API：Chrome 裝置

擷取特定帳戶中的所有 Chrome 裝置
1. 匯出 MEID 清單
擷取 Chrome 裝置
更新 Chrome 裝置
在 Chrome 裝置上採取行動
將 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 帳戶的專屬 ID。
身為帳戶管理員，您也可以使用 my_customer 字串，代表帳戶的 customerId。另一個取得 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)。一般而言，將裝置新增至無線電信業者的後付服務方案時，通常會使用 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 帳戶的專屬 ID。
身為帳戶管理員，您也可以使用 my_customer 字串，代表帳戶的 customerId。另一個取得 customerId 值的方法是使用擷取使用者作業。在作業的 userKey 路徑參數中使用管理員電子郵件地址或管理員專用使用者 id 值。
deviceId 是裝置的專屬 ID，可在擷取所有 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 帳戶的專屬 ID。
身為帳戶管理員，您也可以使用 my_customer 字串，代表帳戶的 customerId。另一個取得 customerId 值的方法是使用擷取使用者作業。在作業的 userKey 路徑參數中使用管理員電子郵件地址或管理員專用使用者 id 值。
deviceId 是裝置的專屬 ID，可在擷取所有 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"
}

如果是更新要求，請只在要求中加入具有更新值的屬性。

注意：API 只能更新 annotatedUser、annotatedLocation、annotatedAssetId、notes 和 orgUnitPath 屬性。

成功的要求會傳回 HTTP 200 狀態碼。除了狀態碼，回應也會傳回更新後 Chrome 裝置的屬性。

取消佈建或停用 Chrome 裝置

如要取消佈建或停用 Chrome 裝置，請使用下列 POST 要求，並附上授權要求中所述的授權。為方便閱讀，這個程式碼範例包含以下程式碼：

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

customerId 是客戶 Google 帳戶的專屬 ID。
身為帳戶管理員，您也可以使用 my_customer 字串，代表帳戶的 customerId。另一個取得 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 裝置移至機構單位

如要將 Chrome 裝置 (最多 50 部) 移至機構單位，請使用以下 POST 要求，並附上授權要求中所述的授權。為方便閱讀，這個程式碼範例包含以下程式碼：

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

customerId 是客戶 Google 帳戶的專屬 ID。
身為帳戶管理員，您也可以使用 my_customer 字串，代表帳戶的 customerId。另一個取得 customerId 值的方法是使用擷取使用者作業。在作業的 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 狀態碼。