特定の属性に一致するデバイスを検索するには、Directory API の mobiledevices.list メソッドを使用します。このメソッドは、1 つ以上の検索句を組み合わせた検索クエリである query パラメータを受け入れます。各検索句は、次の 3 つの部分で構成されます。
- 項目
- 検索対象のデバイス属性。例:
serial - 演算子
- 一致を確定するためにデータに対して実行されるテスト。たとえば、
:演算子は、テキスト属性が値と一致するかどうかをテストします。 - 値
- テスト対象の属性の内容。例:
serialNumber
複数の句は空白文字で区切られ、AND 演算子で暗黙的に結合されます。
例
すべてのクエリで mobiledevices.list メソッドを使用します。このメソッドには、次のような HTTP リクエストが含まれています（読みやすくするために改行が挿入されています）。
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
query パラメータは URL エンコードする必要があります。たとえば、クエリ query=brand:goo* は query=brand%3goo* として URL エンコードされます。このページの例はすべて、エンコードされていない query パラメータを示しています。クライアント ライブラリは、この URL エンコードを自動的に処理します。
シリアル番号の接頭辞に一致するデバイスを検索する
serial:525*
メールアドレスが「fred」で始まるデバイスを検索する
email:fred* email:contact*