Groups Settings API, मौजूदा Google Groups की सेटिंग को अपडेट करता है और उन्हें वापस पाता है. एपीआई की मदद से, ये काम किए जा सकते हैं:
- इंटरनल और एक्सटर्नल ग्रुप के ऐक्सेस के लिए, ग्रुप की सेटिंग में बदलाव करना.
- ग्रुप की सूचनाओं में बदलाव करें.
- चर्चा को संग्रहित करने और मैसेज को मॉडरेट करने की सुविधा कॉन्फ़िगर करें.
- अपने खाते के उपयोगकर्ता ग्रुप को पसंद के मुताबिक बनाएं.
Google Groups के साथ काम करने या अन्य तरह के ग्रुप मैनेज करने के ज़्यादा तरीकों के लिए, Cloud Identity का दस्तावेज़ देखें.
Groups Settings API का डेटा मॉडल
Groups Settings API, Groups रिसॉर्स पर काम करता है. यह रिसॉर्स बताता है कि किसी खाते के उपयोगकर्ता, दूसरे लोगों के ग्रुप के साथ कैसे कम्यूनिकेट करते हैं और साथ मिलकर काम करते हैं.
हर ग्रुप की पहचान, ग्रुप के ईमेल पते से होती है.
एपीआई का डेटा मॉडल, खाते के ग्रुप के Groups कलेक्शन पर आधारित होता है.
हर ग्रुप के लिए, कॉन्फ़िगरेशन सेटिंग का एक यूनीक सेट होता है.
Groups Settings API के ऑपरेशन
Groups Settings API में, ग्रुप की सेटिंग के तरीकों को कॉल किया जा सकता है. इसके बारे में यहां दी गई टेबल में बताया गया है:
| कार्रवाई | ब्यौरा | REST एचटीटीपी मैपिंग |
|---|---|---|
get |
इससे किसी ग्राहक के खाते के लिए, ग्रुप की सेटिंग मिलती हैं. सभी 'पाएं' कार्रवाइयों के लिए, पुष्टि किए गए उपयोगकर्ता से अनुमति लेनी होगी. | किसी ग्रुप यूआरआई पर GET. |
update |
इस तरीके का इस्तेमाल करके, किसी ग्राहक के खाते के लिए ग्रुप की सेटिंग अपडेट की जाती हैं. अपडेट करने से जुड़ी सभी कार्रवाइयों के लिए, पुष्टि किए गए उपयोगकर्ता से अनुमति लेनी होगी. | किसी ग्रुप यूआरआई पर PUT. |
JSON और Atom डेटा फ़ॉर्मैट
डिफ़ॉल्ट रूप से, Groups Settings API, डेटा को JSON फ़ॉर्मैट में दिखाता है. Atom नोटेशन, डेटा का एक वैकल्पिक फ़ॉर्मैट है. JSON और Atom, दोनों डेटा फ़ॉर्मैट में, डेटा को पूरी तरह से पढ़ने और लिखने की सुविधा होती है.
JSON एक सामान्य इंटरनेट फ़ॉर्मैट है. यह किसी भी डेटा स्ट्रक्चर को दिखाने का तरीका उपलब्ध कराता है. json.org के मुताबिक, JSON एक टेक्स्ट फ़ॉर्मैट है. यह किसी भी भाषा पर निर्भर नहीं करता. हालाँकि, इसमें C-फ़ैमिली की भाषाओं के प्रोग्रामर के लिए जाने-पहचाने कन्वेंशन का इस्तेमाल किया जाता है. इनमें 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