Method: contactGroups.create

पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाला नया संपर्क ग्रुप बनाएं.

बनाए गए संपर्क ग्रुप के नाम, उपयोगकर्ताओं के संपर्क ग्रुप के लिए यूनीक होने चाहिए. डुप्लीकेट नाम से ग्रुप बनाने की कोशिश करने पर एचटीटीपी 409 गड़बड़ी दिखेगी.

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

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

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

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

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

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

जेएसओएन के काेड में दिखाना 
{
  "contactGroup": {
    object (ContactGroup)
  },
  "readGroupFields": string
}
फ़ील्ड
contactGroup

object (ContactGroup)

ज़रूरी है. वह संपर्क ग्रुप जिसे बनाना है.
readGroupFields

string (FieldMask format)

ज़रूरी नहीं. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि ग्रुप के कौनसे फ़ील्ड दिखाए जाएं. अगर यह नीति सेट नहीं है या 'खाली है' पर सेट है, तो डिफ़ॉल्ट तौर पर metadata, groupType, और name सेट होता है. मान्य फ़ील्ड हैं:

  • clientData
  • groupType
  • मेटाडेटा
  • नाम

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

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

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

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

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

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