- एचटीटीपी अनुरोध
- पाथ पैरामीटर
- अनुरोध का मुख्य हिस्सा
- जवाब का मुख्य हिस्सा
- अनुमति के दायरे
- इसे आज़माएं!
पुष्टि किए गए उपयोगकर्ता के मालिकाना हक वाले मौजूदा संपर्क ग्रुप का नाम अपडेट करें.
अपडेट किए गए संपर्क ग्रुप के नाम, उपयोगकर्ताओं के संपर्क ग्रुप के लिए यूनीक होने चाहिए. डुप्लीकेट नाम से ग्रुप बनाने की कोशिश करने पर एचटीटीपी 409 गड़बड़ी दिखेगी.
एक ही उपयोगकर्ता के लिए म्यूटेट अनुरोधों को क्रम से भेजा जाना चाहिए, ताकि इंतज़ार के समय में बढ़ोतरी और विफलताओं से बचा जा सके.
एचटीटीपी अनुरोध
PUT https://people.googleapis.com/v1/{contactGroup.resourceName=contactGroups/*}
यह यूआरएल gRPC ट्रांसकोडिंग सिंटैक्स का इस्तेमाल करता है.
पाथ के पैरामीटर
पैरामीटर | |
---|---|
contactGroup.resourceName |
संपर्क ग्रुप के लिए संसाधन का नाम, जिसे सर्वर असाइन करता है. |
अनुरोध का मुख्य भाग
अनुरोध के मुख्य हिस्से में, इस तरह का डेटा शामिल होता है:
जेएसओएन के काेड में दिखाना |
---|
{
"contactGroup": {
"resourceName": string,
"etag": string,
"metadata": {
"updateTime": string,
"deleted": boolean
},
"groupType": enum ( |
फ़ील्ड | |
---|---|
contactGroup.etag |
संसाधन का एचटीटीपी इकाई टैग. इसका इस्तेमाल, वेब कैश मेमोरी की पुष्टि करने के लिए किया जाता है. |
contactGroup.metadata |
सिर्फ़ आउटपुट के लिए. संपर्क ग्रुप के बारे में मेटाडेटा. |
contactGroup.groupType |
सिर्फ़ आउटपुट के लिए. संपर्क ग्रुप का टाइप. |
contactGroup.name |
संपर्क ग्रुप का नाम, जिसे ग्रुप के मालिक ने सेट किया है या सिस्टम ग्रुप के लिए सिस्टम से मिला नाम.
|
contactGroup.formattedName |
सिर्फ़ आउटपुट के लिए. नाम का अनुवाद और उसे दर्शक के खाते की स्थान-भाषा या सिस्टम ग्रुप के नामों के लिए, |
contactGroup.memberResourceNames[] |
सिर्फ़ आउटपुट के लिए. संपर्क व्यक्ति के संसाधन नामों की सूची जो संपर्क ग्रुप के सदस्य हैं. इस फ़ील्ड में सिर्फ़ जीईटी अनुरोधों के लिए जानकारी अपने-आप भर जाती है. इसके बाद, यह फ़ील्ड सिर्फ़ उन सदस्यों के बारे में जानकारी देगा जो |
contactGroup.memberCount |
सिर्फ़ आउटपुट के लिए. ग्रुप में मौजूद संपर्कों की कुल संख्या. इस बात से कोई फ़र्क़ नहीं पड़ता कि अनुरोध में ज़्यादा से ज़्यादा कितने सदस्य हैं. |
contactGroup.clientData[] |
ग्रुप के क्लाइंट का डेटा. |
updateGroupFields |
ज़रूरी नहीं. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि ग्रुप की कौनसी फ़ील्ड अपडेट की जाएं. एक से ज़्यादा फ़ील्ड को कॉमा लगाकर अलग करके, उन्हें तय किया जा सकता है. अगर यह नीति सेट नहीं है या 'खाली है' पर सेट है, तो डिफ़ॉल्ट वैल्यू
|
readGroupFields |
ज़रूरी नहीं. फ़ील्ड मास्क, ताकि यह तय किया जा सके कि ग्रुप के कौनसे फ़ील्ड दिखाए जाएं. अगर यह नीति सेट नहीं है या 'खाली है' पर सेट है, तो डिफ़ॉल्ट तौर पर
|
जवाब का मुख्य भाग
कामयाब रहने पर, जवाब के मुख्य हिस्से में ContactGroup
का एक इंस्टेंस शामिल किया जाता है.
अनुमति के दायरे
नीचे दिए गए OAuth के लिंक की ज़रूरत हाेती है:
https://www.googleapis.com/auth/contacts
ज़्यादा जानकारी के लिए, अनुमति देने से जुड़ी गाइड देखें.