Groups Settings API, मौजूदा Google Group के लिए सेटिंग अपडेट करता है और उन्हें फिर से हासिल करता है. एपीआई की मदद से, ये काम किए जा सकते हैं:
- ग्रुप के इंटरनल और एक्सटर्नल ग्रुप ऐक्सेस करने के लिए, ग्रुप की सेटिंग में बदलाव करें.
- ग्रुप की सूचनाओं में बदलाव करें.
- चर्चा संग्रह और मैसेज मॉडरेशन को कॉन्फ़िगर करें.
- अपने खाते के उपयोगकर्ता ग्रुप को पसंद के मुताबिक बनाएं.
Google Groups के साथ काम करने या दूसरी तरह के ग्रुप को मैनेज करने के अन्य तरीकों के बारे में जानने के लिए, Cloud Identity से जुड़े दस्तावेज़ देखें.
Groups Settings API का डेटा मॉडल
Groups Settings API, Groups संसाधन पर काम करता है. इससे यह पता चलता है कि किसी खाते में मौजूद उपयोगकर्ता, दूसरे लोगों के ग्रुप से कैसे कम्यूनिकेट करते हैं और उसके साथ मिलकर कैसे काम करते हैं. हर ग्रुप की पहचान,
ग्रुप के ईमेल पते से की जाती है.
एपीआई डेटा मॉडल, खाते के ग्रुप के Groups कलेक्शन पर आधारित होता है. हर ग्रुप में, कॉन्फ़िगरेशन सेटिंग का एक खास सेट होता है.
Groups Settings API कार्रवाइयां
इस टेबल में बताए गए तरीके से, Groups सेटिंग एपीआई में ग्रुप सेटिंग को कॉल किया जा सकता है:
| कार्रवाई | ब्यौरा | REST एचटीटीपी मैपिंग |
|---|---|---|
get |
किसी ग्राहक के खाते के लिए, ग्रुप की सेटिंग की जानकारी देता है. नतीजे पाने की सभी कार्रवाइयों की अनुमति ऐसे उपयोगकर्ता के पास होनी चाहिए जिसके पास पुष्टि हो चुकी है. | ग्रुप यूआरआई पर GET. |
update |
ग्राहक के खाते के लिए ग्रुप की सेटिंग अपडेट करता है. अपडेट करने की सभी कार्रवाइयों की पुष्टि करने वाले उपयोगकर्ता की अनुमति होनी चाहिए. | ग्रुप यूआरआई पर PUT. |
JSON और ऐटम डेटा फ़ॉर्मैट
डिफ़ॉल्ट रूप से, Groups Settings API JSON फ़ॉर्मैट में डेटा दिखाता है. ऐटम नोटेशन, एक वैकल्पिक डेटा फ़ॉर्मैट है. JSON और ऐटम डेटा फ़ॉर्मैट, दोनों में ही पूरी रीड-राइट सुविधा काम करती है.
JSON एक आम इंटरनेट फ़ॉर्मैट है, जो आर्बिट्रेरी डेटा स्ट्रक्चर को दिखाने का एक तरीका देता है. json.org के मुताबिक, JSON एक टेक्स्ट फ़ॉर्मैट है. यह पूरी तरह से भाषा पर निर्भर करता है. हालांकि, इसमें ऐसे तरीकों का इस्तेमाल किया जाता है जिन्हें कई भाषाओं के सी-फ़ैमिली प्रोग्राम के प्रोग्रामर जानते हैं. इन भाषाओं में C, C++, C#, Java, JavaScript, Perl, और Python शामिल हैं.
एपीआई का डेटा फ़ॉर्मैट बदलने के लिए, अपने अनुरोध के यूआरआई में alt क्वेरी स्ट्रिंग शामिल करें—उदाहरण के लिए:
JSON
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=json
ऐटम
GET https://www.googleapis.com/groups/v1/groups/salesgroup@example.com?alt=atom