Method: people.createContact

नया संपर्क बनाएं और उस संपर्क के लिए व्यक्ति की जानकारी दिखाएं.

अगर संपर्क फ़ील्ड के लिए सिंगलटन एक फ़ील्ड पर एक से ज़्यादा फ़ील्ड दिए गए हैं, तो अनुरोध 400 गड़बड़ी लौटाता है:

  • जीवनियां
  • जन्मदिन
  • लिंग
  • नाम

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

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

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

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

क्वेरी पैरामीटर

पैरामीटर
personFields

string (FieldMask format)

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

  • पते
  • उम्र की सीमा
  • जीवनियां
  • जन्मदिन
  • CalendarUrls
  • क्लाइंट डेटा
  • कवर फ़ोटो
  • ईमेल पते
  • इवेंट
  • बाहरी आईडी
  • लिंग
  • अग्राहक
  • दिलचस्पियां
  • स्थान-भाषाएं
  • जगहें
  • की पैसे चुकाकर ली जाने वाली सदस्यताएं
  • मेटाडेटा
  • गलत-कीवर्ड
  • नाम
  • निकनेम
  • पेशा
  • संगठन
  • फ़ोन नंबर
  • फ़ोटो
  • रिश्ते
  • sipAddresss
  • कौशल
  • यूआरएल
  • उपयोगकर्ता की पसंद
sources[]

enum (ReadSourceType)

ज़रूरी नहीं. किस तरह का स्रोत दिखाना है, इसका मास्क. अगर इस नीति को सेट नहीं किया जाता है, तो डिफ़ॉल्ट वैल्यू READ_SOURCE_TYPE_CONTACT और READ_SOURCE_TYPE_PROFILE होती है.

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

अनुरोध के मुख्य भाग में Person का उदाहरण है.

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

कामयाब रहने पर, जवाब के मुख्य हिस्से में Person का एक इंस्टेंस शामिल किया जाता है.

अनुमति पाने के लिंक

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

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

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