- एचटीटीपी अनुरोध
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- ContactToCreate
- इसे आज़माएं!
नए संपर्कों का बैच बनाएं और नए संपर्कों के लिए PersonResponse दिखाएं
एक ही उपयोगकर्ता के लिए म्यूटेट अनुरोधों को क्रम से भेजा जाना चाहिए, ताकि इंतज़ार के समय में बढ़ोतरी और विफलताओं से बचा जा सके.
एचटीटीपी अनुरोध
POST https://people.googleapis.com/v1/people:batchCreateContacts
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{ "contacts": [ { object ( |
फ़ील्ड | |
---|---|
contacts[] |
ज़रूरी है. बनाने के लिए संपर्क. एक बार में 200 संपर्कों को जोड़ने की अनुमति दें. |
readMask |
ज़रूरी है. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि जवाब में हर व्यक्ति की किन फ़ील्ड को लौटाया जाए. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. अगर रीड मास्क को खाली छोड़ दिया जाता है, तो पोस्ट-म्यूटेट-गेट को छोड़ दिया जाएगा और जवाब में कोई डेटा नहीं दिखेगा. मान्य मान हैं:
|
sources[] |
ज़रूरी नहीं. यह बताने वाला मास्क कि पोस्ट म्यूटेट रीड में किस तरह के सोर्स का इस्तेमाल किया जाएगा. अगर यह नीति सेट नहीं है, तो डिफ़ॉल्ट वैल्यू |
जवाब का मुख्य भाग
अगर पुष्टि नहीं होती है, तो BatchCreateContactsErrorDetails
दिखाता है. इसमें हर अमान्य संपर्क के लिए गड़बड़ियों की सूची होती है.
संपर्कों का बैच बनाने के अनुरोध का जवाब.
अगर एपीआई सही से जुड़ जाता है, ताे जवाब के मुख्य भाग में नीचे दिए गए स्ट्रक्चर शामिल होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"createdPeople": [
{
object ( |
फ़ील्ड | |
---|---|
createdPeople[] |
बनाए गए संपर्क, जब तक कि |
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.
ContactToCreate
एक रैपर, जिसमें नए बनाए गए सोर्स को पॉप्युलेट करने के लिए, व्यक्ति का डेटा होता है.
जेएसओएन के काेड में दिखाना |
---|
{
"contactPerson": {
object ( |
फ़ील्ड | |
---|---|
contactPerson |
ज़रूरी है. नए बनाए गए सोर्स को पॉप्युलेट करने के लिए, व्यक्ति का डेटा. |