شما میتوانید با استفاده از متد mobiledevices.list از Directory API، دستگاههایی را که با ویژگیهای خاصی مطابقت دارند، جستجو کنید. این متد پارامتر query را میپذیرد که یک query جستجو است که یک یا چند عبارت جستجو را ترکیب میکند. هر عبارت جستجو از سه بخش تشکیل شده است:
- میدان
- ویژگی دستگاهی که جستجو میشود. برای مثال،
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* کدگذاری میشود. تمام مثالهای این صفحه پارامترهای query کدگذاری نشده را نشان میدهند. کتابخانههای کلاینت به طور خودکار این کدگذاری URL را مدیریت میکنند.
جستجوی دستگاههایی که با پیشوند شماره سریال مطابقت دارند
serial:525*
جستجوی دستگاههایی که ایمیل آنها با fred شروع میشود
email:fred* email:contact*