Method: otherContacts.search

पुष्टि किए गए उपयोगकर्ता के दूसरे संपर्कों के संपर्कों की सूची देता है जो खोज क्वेरी से मेल खाते हैं. क्वेरी, 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

string

ज़रूरी है. अनुरोध के लिए सादे टेक्स्ट वाली क्वेरी. क्वेरी का इस्तेमाल किसी व्यक्ति पर फ़ील्ड के उपसर्ग वाक्यांशों से मिलान करने के लिए किया जाता है. उदाहरण के लिए, "foo name" नाम वाला व्यक्ति, "f", "fo", "foo", "foo n", "nam" वगैरह जैसी क्वेरी से मैच करता है, लेकिन "oo n" से नहीं.

pageSize

integer

ज़रूरी नहीं. दिखाए जाने वाले नतीजों की संख्या. अगर फ़ील्ड की वैल्यू सेट नहीं है, तो यह वैल्यू डिफ़ॉल्ट रूप से 10 होती है या 0 पर सेट होती है. 30 से ज़्यादा वैल्यू को 30 तक सीमित किया जाएगा.

readMask

string (FieldMask format)

ज़रूरी है. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि हर व्यक्ति को किन फ़ील्ड को लौटाया जा सकता है. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. मान्य मान हैं:

  • emailAddresses
  • मेटाडेटा
  • names
  • phoneNumbers

अनुरोध का मुख्य भाग

अनुरोध का मुख्य हिस्सा खाली होना चाहिए.

जवाब का मुख्य हिस्सा

कामयाब रहने पर, जवाब के मुख्य हिस्से में SearchResponse का एक इंस्टेंस शामिल किया जाता है.

अनुमति के दायरे

नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:

  • https://www.googleapis.com/auth/contacts.other.readonly

ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.