Directory API: モバイル デバイス

Google Workspace Directory API を使用すると、組織内のモバイル デバイスを管理できます。このページでは、モバイル デバイスを列挙する方法、特定のデバイスの詳細を取得する方法、デバイスを追加または削除する方法の例を紹介します。

このドキュメントは、前提条件を満たしていることを前提としています。Android デバイスには、Device Policy アプリがインストールされている必要があります。iOS デバイスは、Google モバイル管理サービスに登録されている必要があります。

以下の例では、customerId と resourceId というプレースホルダを使用して、これらの ID をどこで指定するかを示しています。customerId は Users.get メソッドから取得できます。resourceId は、デバイスの一意の Google 識別子であり、モバイル デバイスをすべて取得するメソッドのレスポンスにあります。

すべてのモバイル デバイスを取得する

アカウントのすべてのモバイル デバイスを取得するには、次の 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 のステータス コードが返されます。