Directory API:行動裝置

您可以使用 Google Workspace Directory API 管理貴機構的行動裝置。本頁面提供範例,說明如何列出行動裝置、取得特定裝置的詳細資料,以及新增或移除裝置。

本文件假設您已順利完成前置條件。Android 裝置必須安裝裝置政策應用程式。iOS 裝置必須註冊 Google 行動管理服務

在這些範例中,預留位置 customerIdresourceId 用於指出您要提供這些 ID 的位置。您可以從 Users.get 方法取得 customerIdresourceId 是裝置的專屬 Google ID,可在「擷取所有行動裝置」方法的回應中找到。

擷取所有行動裝置

如要擷取帳戶的所有行動裝置,請使用下列 GET 要求,並附上「授權要求」一節中所述的授權。為了方便閱讀,本範例會使用換行符號:

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

如需要求和回應屬性的相關資訊,請參閱 API 參考資料

JSON 回應

{
   "kind": "directory#mobiledevices",
   "mobiledevices": [
    {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Sales"
     ],
     "email": [
      "sales@example.com"
     ],
     "model": "Nexus 4",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "1234567890",
     "firstSync": "2013-05-15T17:30:04.325Z",
     "lastSync": "2013-06-05T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
   },
   {
     "kind": "directory#mobiledevice",
     "resourceId": "resourceId",
     "deviceId": "deviceId",
     "name": [
      "Liz"
     ],
     "email": [
      "liz@example.com"
     ],
     "model": "Galaxy Nexus",
     "os": "Android 4.2.2",
     "type": "ANDROID",
     "status": "APPROVED",
     "hardwareId": "9123456780",
     "firstSync": "2013-06-05T17:30:04.325Z",
     "lastSync": "2013-08-12T17:30:04.325Z",
     "userAgent": "Google Apps Device Policy 4.14",
    }
   ],
   "nextPageToken": "next_page_token_value"
  }

取回行動裝置

如要擷取行動裝置的屬性,請使用下列 GET 要求,並附上「授權要求」一節中所述的授權。為了方便閱讀,本範例會使用換行符號:

GET https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId?projection={FULL|BASIC}

如需要求和回應屬性的相關資訊,請參閱 API 參考資料

JSON 要求

resourceId 的範例要求如下:

GET https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/
  mobile/resourceId?projection=FULL

JSON 回應

{
   "kind": "directory#mobiledevice",
   "resourceId": "resourceId",
   "deviceId": "deviceId",
   "name": [
    "Sales3"
   ],
   "email": [
    "sales@example.com"
   ],
   "model": "Nexus 4",
   "os": "Android 4.2.2",
   "type": "ANDROID",
   "status": "APPROVED",
   "hardwareId": "1234567890",
   "firstSync": "2010-05-15T17:30:04.325Z",
   "lastSync": "2013-06-05T17:30:04.325Z",
   "userAgent": "Google Apps Device Policy 4.14",
  }

核准行動裝置

如要核准行動裝置,請使用下列 POST 要求,並附上「授權要求」一節中所述的授權。為了方便閱讀,本範例會使用換行符號:

POST https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId/action

如需要求和回應屬性的相關資訊,請參閱 API 參考資料

JSON 要求

以下 JSON 要求為核准裝置的示例要求:

POST https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices
  /mobile/resourceId/action

要求主體如下:

{
    "action": "approve"
}

成功的要求會傳回 HTTP 200 狀態碼

移除行動裝置

如要移除行動裝置,請使用下列 DELETE 要求,並附上「授權要求」一節中所述的授權。為了方便閱讀,本範例會使用換行符號:

DELETE https://admin.googleapis.com/admin/directory/v1/customer/{my_customer|customerId}
  /devices/mobile/resourceId

如需要求和回應屬性的相關資訊,請參閱 API 參考資料

成功的要求會傳回 HTTP 200 狀態碼