डायरेक्ट्री एपीआई की 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*