- एचटीटीपी अनुरोध
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
सभी "अन्य संपर्क" की सूची बनाएं, जो वे संपर्क होते हैं जो किसी संपर्क समूह में नहीं हैं. "अन्य संपर्क", आम तौर पर इंटरैक्शन से अपने-आप बने संपर्क होते हैं.
सिंक होने के सात दिन बाद, सिंक टोकन की समयसीमा खत्म हो जाती है. जिस सिंक टोकन की समयसीमा खत्म हो चुकी है उसे अनुरोध करने पर google.rpc.ErrorInfo में गड़बड़ी मिलेगी. साथ ही, इसकी वजह "EXPIRED_SYNC_TOKEN" होगी. ऐसी स्थिति में, क्लाइंट को
के बिना, सिंक करने का पूरा अनुरोध करना चाहिए.syncToken
सिंक करने के पूरे अनुरोध के पहले पेज का कोटा अतिरिक्त होता है. अगर कोटा ज़्यादा हो जाता है, तो 429 वाली गड़बड़ी दिखेगी. यह कोटा तय है और इसे बढ़ाया नहीं जा सकता.
के बारे में बताने पर, पिछले सिंक के बाद से मिटाए गए संसाधन, उस व्यक्ति के तौर पर दिखाए जाएंगे जिसका syncToken
'सही' पर सेट है.PersonMetadata.deleted
या pageToken
के बारे में बताने पर, दूसरे सभी अनुरोध पैरामीटर, पहली कॉल से मेल खाने चाहिए.syncToken
सिंक के अनुरोधों को लागू होने में कुछ मिनट लग सकते हैं. इंक्रीमेंटल सिंक, 'लिखने के बाद पढ़ने' वाले इस्तेमाल के उदाहरणों के लिए नहीं बनाए गए हैं.
उपयोगकर्ता के उन अन्य संपर्कों की सूची बनाएं जिनमें बदलाव किए गए हैं पर जाकर, इस्तेमाल के उदाहरण देखें.
एचटीटीपी अनुरोध
GET https://people.googleapis.com/v1/otherContacts
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
क्वेरी पैरामीटर
पैरामीटर | |
---|---|
pageToken |
ज़रूरी नहीं. पिछले जवाब पेजों को क्रम में लगाते समय, |
pageSize |
ज़रूरी नहीं. जवाब में शामिल किए जाने वाले "अन्य संपर्कों" की संख्या. मान्य वैल्यू 1 से 1, 000 के बीच की होनी चाहिए. इसमें दोनों शामिल हैं. अगर यह वैल्यू सेट नहीं है या 0 पर सेट है, तो डिफ़ॉल्ट वैल्यू 100 होती है. |
requestSyncToken |
ज़रूरी नहीं. नतीजों के आखिरी पेज पर, जवाब के तौर पर सिंक के व्यवहार के बारे में ज़्यादा जानकारी |
syncToken |
ज़रूरी नहीं. पिछले जवाब से मिला सिंक टोकन सिंक करते समय, सिंक के व्यवहार के बारे में ज़्यादा जानकारी |
readMask |
ज़रूरी है. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि हर व्यक्ति को किन फ़ील्ड को लौटाया जा सकता है. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. मान्य वैल्यू इस बात पर निर्भर करती हैं कि ReadSourceType का इस्तेमाल किया गया है या नहीं. अगर READ_SOURCE_TYPE_CONTACT का इस्तेमाल किया जाता है, तो मान्य वैल्यू ये हैं:
अगर READ_SOURCE_TYPE_PROFILE का इस्तेमाल किया जाता है, तो मान्य वैल्यू ये हैं:
|
sources[] |
ज़रूरी नहीं. इस बात का मास्क कि किस तरह के सोर्स को दिखाया जाए. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट वैल्यू इस फ़ील्ड के लिए संभावित वैल्यू ये हैं:
|
अनुरोध का मुख्य भाग
अनुरोध का मुख्य हिस्सा खाली होना चाहिए.
जवाब का मुख्य भाग
पुष्टि किए गए उपयोगकर्ता के "अन्य संपर्क" के अनुरोध का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"otherContacts": [
{
object ( |
फ़ील्ड | |
---|---|
otherContacts[] |
"अन्य संपर्क" की सूची, निजी जानकारी के संसाधनों के तौर पर दिखती है. "अन्य संपर्क" में, फ़ील्ड के सीमित सबसेट का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, ListOtherContactsRequest.request_mask पर जाएं. |
nextPageToken |
एक टोकन, जिसे अगला पेज वापस पाने के लिए |
nextSyncToken |
ऐसा टोकन जिसे पिछले अनुरोध के बाद किए गए बदलावों को वापस पाने के लिए, |
totalSize |
पेज पर नंबर लगाए बिना सूची में मौजूद अन्य संपर्कों की कुल संख्या. |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts.other.readonly
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.