- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
पुष्टि किए गए उपयोगकर्ता की डोमेन डायरेक्ट्री में मौजूद उन डोमेन प्रोफ़ाइलों और डोमेन संपर्कों की सूची उपलब्ध कराता है जो खोज क्वेरी से मेल खाते हैं.
एचटीटीपी अनुरोध
GET https://people.googleapis.com/v1/people:searchDirectoryPeople
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
query |
ज़रूरी है. व्यक्ति के फ़ील्ड से मेल खाने वाली प्रीफ़िक्स क्वेरी. यह तय करने के लिए कि कौनसे फ़ील्ड को मैच करना है, ReadMask का इस्तेमाल नहीं करता. |
readMask |
ज़रूरी है. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि हर व्यक्ति को किन फ़ील्ड को लौटाया जा सकता है. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. मान्य मान हैं:
|
sources[] |
ज़रूरी है. दिए जाने वाले डायरेक्ट्री के सोर्स. |
mergeSources[] |
ज़रूरी नहीं. अगर पुष्टि की गई जॉइन की, जैसे कि ईमेल पते या फ़ोन नंबर की मदद से कनेक्ट किया गया है, तो डायरेक्ट्री सोर्स में मर्ज किया जाने वाला अतिरिक्त डेटा. |
pageSize |
ज़रूरी नहीं. जवाब में शामिल किए जाने वाले लोगों की संख्या. मान्य वैल्यू 1 से 500 के बीच की होती हैं. इनमें भी शामिल हैं. अगर यह वैल्यू सेट नहीं है या 0 पर सेट है, तो डिफ़ॉल्ट वैल्यू 100 होती है. |
pageToken |
ज़रूरी नहीं. पिछले जवाब पेज में नंबर डालकर, [ |
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
पुष्टि किए गए उपयोगकर्ता की डोमेन डायरेक्ट्री में मौजूद लोगों से मिले ऐसे अनुरोध का जवाब जो दी गई क्वेरी से मेल खाता हो.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"people": [
{
object ( |
फ़ील्ड | |
---|---|
people[] |
डोमेन डायरेक्ट्री में मौजूद उन लोगों की सूची जो क्वेरी से मेल खाते हैं. |
nextPageToken |
एक टोकन, जिसे अगला पेज वापस पाने के लिए |
totalSize |
पेज पर नंबर न डाले बिना, सूची में मौजूद आइटम की कुल संख्या. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/directory.readonly
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.