Method: mobiledevices.list

アカウントのユーザー所有のすべてのモバイル デバイスのパージネーション リストを取得します。会社所有のデバイスを含むリストを取得するには、代わりに Cloud Identity の Devices API を使用します。このメソッドは 60 分後にタイムアウトします。詳細については、エラーコードのトラブルシューティングをご覧ください。

HTTP リクエスト

GET https://admin.googleapis.com/admin/directory/v1/customer/{customerId}/devices/mobile

この URL は gRPC Transcoding 構文を使用します。

パスパラメータ

パラメータ
customerId

string

お客様の Google Workspace アカウントの一意の ID。アカウント管理者は、アカウントの customerId を表す my_customer エイリアスを使用することもできます。customerId は、ユーザー リソースの一部としても返されます。

クエリ パラメータ

パラメータ
maxResults

integer

返される結果の最大数。最大値は 100 です。
orderBy

enum (OrderBy)

結果の並べ替えに使用するデバイスのプロパティです。
pageToken

string

リストの次のページを指定するトークン
projection

enum (Projection)

選択した一連のフィールドに返される情報を制限します。
query

string

https://developers.google.com/workspace/admin/directory/v1/search-operators に記載されている形式の検索文字列
sortOrder

enum (SortOrder)

結果を昇順または降順のどちらで返すかを指定します。orderBy パラメータと一緒に使用する必要があります。

リクエストの本文

リクエストの本文は空にする必要があります。

レスポンスの本文

成功すると、レスポンスの本文に次の構造のデータが含まれます。

JSON 表現 
{
  "kind": string,
  "etag": string,
  "mobiledevices": [
    {
      object (MobileDevice)
    }
  ],
  "nextPageToken": string
}
フィールド
kind

string

リソースの種類。
etag

string

リソースの ETag。
mobiledevices[]

object (MobileDevice)

モバイル デバイス オブジェクトのリスト。
nextPageToken

string

この結果の次のページにアクセスするために使用されるトークン。

認可スコープ

以下のいずれかの OAuth スコープが必要です。

  • https://www.googleapis.com/auth/admin.directory.device.mobile
  • https://www.googleapis.com/auth/admin.directory.device.mobile.action
  • https://www.googleapis.com/auth/admin.directory.device.mobile.readonly

詳しくは、認可ガイドをご覧ください。

OrderBy

列挙型
DEVICE_ID Google Sync モバイル デバイスのシリアル番号。Android デバイスの場合、これはソフトウェアによって生成された一意の識別子です。
EMAIL デバイスのオーナーのメールアドレス。
LAST_SYNC デバイスのポリシー設定の最終同期日時。
MODEL モバイル デバイスのモデル。
NAME デバイスの所有者のユーザー名。
OS デバイスのオペレーティング システム。
STATUS デバイスのステータス。
TYPE 端末のタイプ。

予測

列挙型
BASIC 基本的なメタデータ フィールドのみが含まれます（deviceId、model、status、type、status など）。
FULL すべてのメタデータ フィールドが含まれます

SortOrder

列挙型
ASCENDING 昇順。
DESCENDING 降順。