Method: people.updateContact

किसी मौजूदा संपर्क व्यक्ति का संपर्क डेटा अपडेट करना. बिना संपर्क वाले डेटा में कोई बदलाव नहीं किया जाएगा. जिस व्यक्ति की जानकारी अपडेट करनी है उसमें मौजूद ऐसा कोई भी डेटा अनदेखा कर दिया जाएगा जो संपर्क से जुड़ा नहीं है. updateMask में बताए गए सभी फ़ील्ड बदल दिए जाएंगे.

अगर अपडेट किए जाने वाले संपर्क के लिए person.metadata.sources नहीं दिया गया है या संपर्क का कोई सोर्स नहीं है, तो सर्वर 400 कोड वाली गड़बड़ी दिखाता है.

अगर person.metadata.sources.etag, संपर्क के ईटीएजी से अलग है, तो सर्वर "failedPrecondition" की वजह से 400 कोड वाली गड़बड़ी दिखाता है. इससे पता चलता है कि संपर्क का डेटा पढ़े जाने के बाद, उसमें बदलाव हुआ है. क्लाइंट को सबसे नया व्यक्ति मिलना चाहिए और अपने अपडेट को उसमें मर्ज करना चाहिए. अगर एक ही व्यक्ति के लिए क्रम से अपडेट किए जा रहे हैं, तो updateContact रिस्पॉन्स से मिले etag का इस्तेमाल किया जाना चाहिए, ताकि कोई गड़बड़ी न हो.

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

अगर संपर्क सोर्स के लिए सिंगलटन फ़ील्ड में एक से ज़्यादा फ़ील्ड तय किए जाते हैं, तो सर्वर 400 कोड वाली गड़बड़ी दिखाता है:

  • जीवनियां
  • जन्मदिन
  • लिंग
  • नाम

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

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

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
  • रुचियां
  • स्थान-भाषाएं
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • miscKeywords
  • नाम
  • निकनेम
  • पेशे
  • संगठन
  • phoneNumbers
  • संबंध
  • sipAddresses
  • यूआरएल
  • userDefined
personFields

string (FieldMask format)

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

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

enum (ReadSourceType)

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

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

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

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

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

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

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

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

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