特定の属性と一致するデバイスを検索するには、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* というクエリを URL エンコードすると query=brand%3goo* になります。このページのすべての例では、query パラメータをエンコードせずに表記しています。クライアント ライブラリは、この URL エンコードを自動的に行います。
シリアル番号のプレフィックスが一致するデバイスを検索する
serial:525*
メールアドレスが fred で始まるデバイスを検索する
email:fred* email:contact*