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