Method: people.updateContact

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

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

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

अगर 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
  • क्लाइंट डेटा
  • ईमेल पते
  • इवेंट
  • बाहरी आईडी
  • लिंग
  • अग्राहक
  • दिलचस्पियां
  • स्थान-भाषाएं
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • गलत-कीवर्ड
  • नाम
  • निकनेम
  • पेशा
  • संगठन
  • फ़ोन नंबर
  • रिश्ते
  • sipAddresss
  • यूआरएल
  • उपयोगकर्ता की पसंद
personFields

string (FieldMask format)

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

  • पते
  • उम्र की सीमा
  • जीवनियां
  • जन्मदिन
  • CalendarUrls
  • क्लाइंट डेटा
  • कवर फ़ोटो
  • ईमेल पते
  • इवेंट
  • बाहरी आईडी
  • लिंग
  • अग्राहक
  • दिलचस्पियां
  • स्थान-भाषाएं
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • मेटाडेटा
  • गलत-कीवर्ड
  • नाम
  • निकनेम
  • पेशा
  • संगठन
  • फ़ोन नंबर
  • फ़ोटो
  • रिश्ते
  • sipAddresss
  • कौशल
  • यूआरएल
  • उपयोगकर्ता की पसंद
sources[]

enum (ReadSourceType)

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

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

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

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

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

अनुमति पाने के लिंक

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

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

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