- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
पुष्टि किए गए उपयोगकर्ता के दूसरे संपर्कों के संपर्कों की सूची देता है जो खोज क्वेरी से मेल खाते हैं. क्वेरी, OTHER_CONTACT
सोर्स के names
, emailAddresses
, और phoneNumbers
फ़ील्ड से मैच हो रही है.
अहम जानकारी: खोज करने से पहले, क्लाइंट को कैश मेमोरी को अपडेट करने के लिए, खाली क्वेरी के साथ वॉर्मअप का अनुरोध भेजना चाहिए. https://developers.google.com/people/v1/other-contacts#search_the_users_other_contacts पर जाएं
एचटीटीपी अनुरोध
GET https://people.googleapis.com/v1/otherContacts:search
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
query |
ज़रूरी है. अनुरोध के लिए सादे टेक्स्ट वाली क्वेरी. क्वेरी का इस्तेमाल किसी व्यक्ति पर फ़ील्ड के उपसर्ग वाक्यांशों से मिलान करने के लिए किया जाता है. उदाहरण के लिए, "foo name" नाम वाला व्यक्ति, "f", "fo", "foo", "foo n", "nam" वगैरह जैसी क्वेरी से मैच करता है, लेकिन "oo n" से नहीं. |
pageSize |
ज़रूरी नहीं. दिखाए जाने वाले नतीजों की संख्या. अगर फ़ील्ड की वैल्यू सेट नहीं है, तो यह वैल्यू डिफ़ॉल्ट रूप से 10 होती है या 0 पर सेट होती है. 30 से ज़्यादा वैल्यू को 30 तक सीमित किया जाएगा. |
readMask |
ज़रूरी है. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि हर व्यक्ति को किन फ़ील्ड को लौटाया जा सकता है. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. मान्य मान हैं:
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य हिस्सा
कामयाब रहने पर, जवाब के मुख्य हिस्से में SearchResponse
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts.other.readonly
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.