Method: people.updateContact

किसी मौजूदा संपर्क व्यक्ति का संपर्क डेटा अपडेट करें. जिस डेटा में संपर्क नहीं है उसमें बदलाव नहीं किया जाएगा. अपडेट किए जाने वाले व्यक्ति के ऐसे किसी भी डेटा को अनदेखा कर दिया जाएगा जो संपर्क नहीं है. 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

string

सर्वर से असाइन किए गए, व्यक्ति के लिए संसाधन का नाम. people/{person_id} के तौर पर ASCII स्ट्रिंग.

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

पैरामीटर
updatePersonFields

string (FieldMask format)

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

  • पते
  • जीवनियां
  • जन्मदिन
  • calendarUrls
  • clientData
  • emailAddresses
  • इवेंट
  • externalIds
  • लिंग
  • imClients
  • दिलचस्पियां
  • locales
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • miscKeywords
  • names
  • प्रचलित नाम
  • व्यवसाय
  • organizations
  • phoneNumbers
  • संबंध
  • sipAddresses
  • urls
  • userDefined
personFields

string (FieldMask format)

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

  • पते
  • 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_PROFILE होती है.

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

अनुरोध के मुख्य भाग में Person का उदाहरण है.

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

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

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

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

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

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