Method: people.batchCreateContacts

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

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

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

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

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

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

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

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

object (ContactToCreate)

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

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

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

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

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

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

object (PersonResponse)

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

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

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

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

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

ContactToCreate

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

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

object (Person)

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