您可以使用 Google Workspace Directory API 管理貴機構的行動裝置。本頁面提供範例,說明如何列出行動裝置、取得特定裝置的詳細資料,以及新增或移除裝置。
本文件假設您已順利完成前置條件。Android 裝置必須安裝裝置政策應用程式。iOS 裝置必須註冊 Google 行動管理服務。
在這些範例中,預留位置 customerId 和 resourceId 用於指出您要提供這些 ID 的位置。您可以從 Users.get 方法取得 customerId。resourceId 是裝置的專屬 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 狀態碼。