- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- क्वेरी पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
किसी मौजूदा संपर्क व्यक्ति का संपर्क डेटा अपडेट करें. जिस डेटा में संपर्क नहीं है उसमें बदलाव नहीं किया जाएगा. अपडेट किए जाने वाले व्यक्ति के ऐसे किसी भी डेटा को अनदेखा कर दिया जाएगा जो संपर्क नहीं है. updateMask में दिए गए सभी फ़ील्ड बदल दिए जाएंगे.
अगर संपर्क को अपडेट करने के लिए person.metadata.sources तय नहीं किया गया है या संपर्क का कोई सोर्स नहीं है, तो सर्वर 400 गड़बड़ी वाला मैसेज दिखाता है.
अगर person.metadata.sources.etag, संपर्क के etag से अलग है, तो सर्वर "failedPrecondition" वजह के साथ 400 गड़बड़ी वाला मैसेज दिखाता है. इससे पता चलता है कि संपर्क का डेटा पढ़ने के बाद उसमें बदलाव हो गया है. क्लाइंट को नए लोगों की जानकारी लेनी चाहिए और उनके अपडेट को, नए व्यक्ति के अपडेट में मर्ज करना चाहिए.
अगर memberships अपडेट किया जा रहा है और उस व्यक्ति पर कोई संपर्क समूह सदस्यता नहीं दी गई है, तो सर्वर 400 गड़बड़ी वाला मैसेज दिखाता है.
अगर किसी ऐसे फ़ील्ड पर एक से ज़्यादा फ़ील्ड दिए गए हैं जो संपर्क स्रोतों के लिए सिंगलटन है, तो सर्वर 400 गड़बड़ी वाला मैसेज दिखाता है:
- जीवनियां
- जन्मदिन
- लिंग
- names
एक ही उपयोगकर्ता के लिए म्यूटेट अनुरोधों को क्रम से भेजा जाना चाहिए, ताकि इंतज़ार के समय में बढ़ोतरी और विफलताओं से बचा जा सके.
एचटीटीपी अनुरोध
PATCH https://people.googleapis.com/v1/{person.resourceName=people/*}:updateContact
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
| पैरामीटर | |
|---|---|
person.resourceName |
सर्वर से असाइन किए गए, व्यक्ति के लिए संसाधन का नाम. |
क्वेरी पैरामीटर
| पैरामीटर | |
|---|---|
updatePersonFields |
ज़रूरी है. फ़ील्ड मास्क, यह प्रतिबंधित करता है कि व्यक्ति की कौनसी फ़ील्ड अपडेट की जाएं. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. अपडेट किए गए सभी फ़ील्ड बदल दिए जाएंगे. मान्य मान हैं:
|
personFields |
ज़रूरी नहीं. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि हर व्यक्ति को किन फ़ील्ड को लौटाया जा सकता है. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. अगर यह वैल्यू सेट नहीं है, तो यह सभी फ़ील्ड को डिफ़ॉल्ट तौर पर सेट करती है. मान्य मान हैं:
|
sources[] |
ज़रूरी नहीं. इस बात का मास्क कि किस तरह के सोर्स को दिखाया जाए. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट वैल्यू |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य भाग में Person का उदाहरण है.
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में Person का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.