Method: people.batchCreateContacts

नए संपर्कों का बैच बनाएं और नए संपर्कों के लिए PersonResponse दिखाएं

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

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

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

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

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

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

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

object (ContactToCreate)

ज़रूरी है. बनाने के लिए संपर्क. एक बार में 200 संपर्कों को जोड़ने की अनुमति दें.
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 होती है.

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

अगर पुष्टि नहीं होती है, तो BatchCreateContactsErrorDetails दिखाता है. इसमें हर अमान्य संपर्क के लिए गड़बड़ियों की सूची होती है.

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

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

जेएसओएन के काेड में दिखाना 
{
  "createdPeople": [
    {
      object (PersonResponse)
    }
  ]
}
फ़ील्ड
createdPeople[]

object (PersonResponse)

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

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

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

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

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

ContactToCreate

एक रैपर, जिसमें नए बनाए गए सोर्स को पॉप्युलेट करने के लिए, व्यक्ति का डेटा होता है.

जेएसओएन के काेड में दिखाना 
{
  "contactPerson": {
    object (Person)
  }
}
फ़ील्ड
contactPerson

object (Person)

ज़रूरी है. नए बनाए गए सोर्स को पॉप्युलेट करने के लिए, व्यक्ति का डेटा.