Method: otherContacts.list

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

पूरी तरह सिंक होने के सात दिन बाद, सिंक टोकन की समयसीमा खत्म हो जाती है. जिस सिंक टोकन की समयसीमा खत्म हो चुकी है उसके अनुरोध को "EXPIRED_SYNC_TOKEN" वजह से google.rpc.ErrorInfo में गड़बड़ी मिलेगी. ऐसी गड़बड़ी होने पर, क्लाइंट को 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
  • मेटाडेटा
  • नाम
  • phoneNumbers
  • फ़ोटोज

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

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

enum (ReadSourceType)

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

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

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

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

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

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

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

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

JSON के काेड में दिखाना 
{
  "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

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