Method: people.batchUpdateContacts

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

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

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

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

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

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

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

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

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

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

अगर अनुरोध स्वीकार नहीं किया जाता है, तो हर संपर्क से जुड़ी गड़बड़ियों की सूची, BatchUpdateContactsErrorDetails दिखाता है.

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

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

JSON के काेड में दिखाना 
{
  "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

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