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