Method: people.batchUpdateContacts

संपर्कों के बैच को अपडेट करें और अपडेट किए गए संपर्कों के लिए, PersonResponses को संसाधनों के नामों का मैप दिखाएं.

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

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

POST https://people.googleapis.com/v1/people:batchUpdateContacts

यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.

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

अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:

जेएसओएन के काेड में दिखाना 
{
  "contacts": {
    string: {
      object (Person)
    },
    ...
  },
  "updateMask": string,
  "readMask": string,
  "sources": [
    enum (ReadSourceType)
  ]
}
फ़ील्ड
contacts

map (key: string, value: object (Person))

ज़रूरी है. व्यक्ति के डेटा को अपडेट करने के लिए, संसाधन के नामों का मैप. एक बार में 200 संपर्कों को जोड़ने की अनुमति दें.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.
updateMask

string (FieldMask format)

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

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

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 होती है.

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

अगर robots.txt फ़ाइल नहीं मिलती है, तो हर संपर्क से जुड़ी गड़बड़ियों की सूची BatchUpdateContactsErrorDetails दिखाता है.

संपर्कों के बैच को अपडेट करने के अनुरोध का जवाब.

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

जेएसओएन के काेड में दिखाना 
{
  "updateResult": {
    string: {
      object (PersonResponse)
    },
    ...
  }
}
फ़ील्ड
updateResult

map (key: string, value: object (PersonResponse))

अपडेट किए गए संपर्कों के संसाधन के नामों का मैप, जब तक कि readMask अनुरोध खाली न हो.

एक ऑब्जेक्ट, जिसमें "key": value पेयर की सूची है. उदाहरण: { "name": "wrench", "mass": "1.3kg", "count": "3" }.

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

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

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

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