Method: otherContacts.list

सभी "अन्य संपर्क" की सूची बनाएं, जो वे संपर्क होते हैं जो किसी संपर्क समूह में नहीं हैं. "अन्य संपर्क", आम तौर पर इंटरैक्शन से अपने-आप बने संपर्क होते हैं.

सिंक होने के सात दिन बाद, सिंक टोकन की समयसीमा खत्म हो जाती है. जिस सिंक टोकन की समयसीमा खत्म हो चुकी है उसे अनुरोध करने पर google.rpc.ErrorInfo में गड़बड़ी मिलेगी. साथ ही, इसकी वजह "EXPIRED_SYNC_TOKEN" होगी. ऐसी स्थिति में, क्लाइंट को syncToken के बिना, सिंक करने का पूरा अनुरोध करना चाहिए.

सिंक करने के पूरे अनुरोध के पहले पेज का कोटा अतिरिक्त होता है. अगर कोटा ज़्यादा हो जाता है, तो 429 वाली गड़बड़ी दिखेगी. यह कोटा तय है और इसे बढ़ाया नहीं जा सकता.

syncToken के बारे में बताने पर, पिछले सिंक के बाद से मिटाए गए संसाधन, उस व्यक्ति के तौर पर दिखाए जाएंगे जिसका PersonMetadata.deleted 'सही' पर सेट है.

pageToken या syncToken के बारे में बताने पर, दूसरे सभी अनुरोध पैरामीटर, पहली कॉल से मेल खाने चाहिए.

सिंक के अनुरोधों को लागू होने में कुछ मिनट लग सकते हैं. इंक्रीमेंटल सिंक, 'लिखने के बाद पढ़ने' वाले इस्तेमाल के उदाहरणों के लिए नहीं बनाए गए हैं.

उपयोगकर्ता के उन अन्य संपर्कों की सूची बनाएं जिनमें बदलाव किए गए हैं पर जाकर, इस्तेमाल के उदाहरण देखें.

एचटीटीपी अनुरोध

GET https://people.googleapis.com/v1/otherContacts

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

क्वेरी पैरामीटर

पैरामीटर
pageToken

string

ज़रूरी नहीं. पिछले जवाब nextPageToken से मिला पेज टोकन. बाद वाला पेज फिर से पाने के लिए यह विकल्प दें.

पेजों को क्रम में लगाते समय, otherContacts.list को दिए गए अन्य सभी पैरामीटर, पेज टोकन देने वाले पहले कॉल से मेल खाने चाहिए.

pageSize

integer

ज़रूरी नहीं. जवाब में शामिल किए जाने वाले "अन्य संपर्कों" की संख्या. मान्य वैल्यू 1 से 1, 000 के बीच की होनी चाहिए. इसमें दोनों शामिल हैं. अगर यह वैल्यू सेट नहीं है या 0 पर सेट है, तो डिफ़ॉल्ट वैल्यू 100 होती है.

requestSyncToken

boolean

ज़रूरी नहीं. नतीजों के आखिरी पेज पर, जवाब के तौर पर nextSyncToken दिखना चाहिए या नहीं. इसका इस्तेमाल पिछले अनुरोध के बाद, बढ़ोतरी के हिसाब से किए जाने वाले बदलावों को पाने के लिए किया जा सकता है. इसके लिए, इसे syncToken अनुरोध पर सेट करें.

सिंक के व्यवहार के बारे में ज़्यादा जानकारी otherContacts.list पर उपलब्ध है.

syncToken

string

ज़रूरी नहीं. पिछले जवाब से मिला सिंक टोकन nextSyncToken सिर्फ़ पिछले अनुरोध के बाद बदले गए संसाधनों को वापस पाने के लिए इसे उपलब्ध कराएं.

सिंक करते समय, otherContacts.list को दिए गए अन्य सभी पैरामीटर, सिंक टोकन देने वाले पहले कॉल से मेल खाने चाहिए.

सिंक के व्यवहार के बारे में ज़्यादा जानकारी otherContacts.list पर उपलब्ध है.

readMask

string (FieldMask format)

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

अगर READ_SOURCE_TYPE_CONTACT का इस्तेमाल किया जाता है, तो मान्य वैल्यू ये हैं:

  • emailAddresses
  • मेटाडेटा
  • names
  • phoneNumbers
  • फ़ोटोज

अगर READ_SOURCE_TYPE_PROFILE का इस्तेमाल किया जाता है, तो मान्य वैल्यू ये हैं:

  • पते
  • ageRanges
  • जीवनियां
  • जन्मदिन
  • calendarUrls
  • clientData
  • coverPhotos
  • emailAddresses
  • इवेंट
  • externalIds
  • लिंग
  • imClients
  • दिलचस्पियां
  • locales
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • मेटाडेटा
  • miscKeywords
  • names
  • प्रचलित नाम
  • व्यवसाय
  • organizations
  • phoneNumbers
  • फ़ोटोज
  • संबंध
  • sipAddresses
  • कौशल
  • urls
  • userDefined
sources[]

enum (ReadSourceType)

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

इस फ़ील्ड के लिए संभावित वैल्यू ये हैं:

READ_SOURCE_TYPE_CONTACT को तय किए बिना READ_SOURCE_TYPE_PROFILE को तय करने की अनुमति नहीं है.

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

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

जवाब का मुख्य भाग

पुष्टि किए गए उपयोगकर्ता के "अन्य संपर्क" के अनुरोध का जवाब.

अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.

जेएसओएन के काेड में दिखाना
{
  "otherContacts": [
    {
      object (Person)
    }
  ],
  "nextPageToken": string,
  "nextSyncToken": string,
  "totalSize": integer
}
फ़ील्ड
otherContacts[]

object (Person)

"अन्य संपर्क" की सूची, निजी जानकारी के संसाधनों के तौर पर दिखती है. "अन्य संपर्क" में, फ़ील्ड के सीमित सबसेट का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, ListOtherContactsRequest.request_mask पर जाएं.

nextPageToken

string

एक टोकन, जिसे अगला पेज वापस पाने के लिए pageToken के तौर पर भेजा जा सकता है. अगर इस फ़ील्ड को खाली छोड़ा जाता है, तो इसके बाद कोई पेज नहीं होगा.

nextSyncToken

string

ऐसा टोकन जिसे पिछले अनुरोध के बाद किए गए बदलावों को वापस पाने के लिए, syncToken के तौर पर भेजा जा सकता है. सिंक टोकन वापस करने के लिए, अनुरोध को requestSyncToken को सेट करना होगा.

totalSize

integer

पेज पर नंबर लगाए बिना सूची में मौजूद अन्य संपर्कों की कुल संख्या.

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

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

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

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