डायरेक्ट्री एपीआई के mobiledevices.list तरीके का इस्तेमाल करके, कुछ एट्रिब्यूट से मेल खाने वाले डिवाइसों को खोजा जा सकता है. यह तरीका, query पैरामीटर को स्वीकार करता है. यह एक खोज क्वेरी है, जिसमें एक या उससे ज़्यादा खोज क्लॉज़ शामिल होते हैं. खोज के हर क्लॉज़ में तीन हिस्से होते हैं:
- फ़ील्ड
- डिवाइस एट्रिब्यूट, जिसे खोजा जाता है. उदाहरण के लिए,
serial. - ऑपरेटर
- मैच करने के लिए, डेटा पर किया गया टेस्ट. उदाहरण के लिए,
:ऑपरेटर यह जांच करता है कि क्या कोई टेक्स्ट एट्रिब्यूट, किसी वैल्यू से मिलता है. - मान
- जांच किए गए एट्रिब्यूट की वैल्यू. उदाहरण के लिए,
serialNumber.
एक से ज़्यादा क्लॉज़ को खाली जगह से अलग किया जाता है और उन्हें AND ऑपरेटर से जोड़ा जाता है.
उदाहरण
सभी क्वेरी, mobiledevices.list
मेथड का इस्तेमाल करती हैं. इसमें एचटीटीपी अनुरोध इस तरह का होता है (पढ़ने में आसानी के लिए लाइन ब्रेक शामिल किए गए हैं):
GET https://admin.googleapis.com/admin/directory/v1/customer/customerId/devices/mobile
?query=query parameters
query पैरामीटर को कोड में बदलना ज़रूरी है. उदाहरण के लिए, क्वेरी query=brand:goo* को यूआरएल के तौर पर query=brand%3goo* में कोड किया गया है.
इस पेज पर दिए गए सभी उदाहरणों में, अनकोड किए गए query पैरामीटर दिखाए गए हैं.
क्लाइंट लाइब्रेरी, यूआरएल एन्कोडिंग को अपने-आप मैनेज करती हैं.
किसी सीरियल नंबर के प्रीफ़िक्स से मेल खाने वाले डिवाइसों को खोजना
serial:525*
fred से शुरू होने वाले ईमेल पते वाले डिवाइसों को खोजो
email:fred* email:contact*