デバイスの検索

特定の属性と一致するデバイスを検索するには、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*