कोई भी डेवलपर, Google Classroom API से अनुरोध कर सकता है. हालांकि, Google Classroom की कुछ सुविधाएं सिर्फ़ कुछ उपयोगकर्ताओं के लिए उपलब्ध हैं. हर सुविधा के लिए अलग-अलग ज़रूरी शर्तें हो सकती हैं. जैसे, Google Workspace for Education के किसी खास लाइसेंस टाइप का होना. Google Workspace for Education के हर लाइसेंस लेवल पर मिलने वाली सुविधाओं के बारे में ज़्यादा जानने के लिए, अलग-अलग वर्शन की तुलना दिखाने वाला पेज देखें.
ज़रूरी शर्तें पूरी करने पर मिलने वाली सुविधाएं
Classroom API की ये सुविधाएं, सिर्फ़ ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं के लिए उपलब्ध हैं:
- Classroom ऐड-ऑन के अटैचमेंट बनाना और उनमें बदलाव करना.
- ग्रेडिंग पीरियड की सेटिंग में बदलाव करना.
- रूब्रिक बनाना, उनमें बदलाव करना, और उन्हें मिटाना.
उपयोगकर्ता की क्षमताओं का पता लगाना
Classroom API को अनुरोध, उपयोगकर्ताओं की ओर से किए जाते हैं. इसलिए, आपको यह जांच करनी चाहिए कि किसी उपयोगकर्ता के पास ज़रूरी शर्तें पूरी करने की क्षमता है या नहीं. इसके बाद ही, ज़रूरी शर्तों के साथ एपीआई अनुरोध जारी करें.
यह पता लगाने के लिए कि किसी उपयोगकर्ता के पास कोई सुविधा है या नहीं, checkUserCapability तरीके से एपीआई अनुरोध करें. Classroom की जिस सुविधा का इस्तेमाल करना है उसके लिए, सही Capability टाइप शामिल करें. हर सुविधा के लिए, सही Capability बताएं:
| यह देखने के लिए कि उपयोगकर्ता... | Capability |
|---|---|
| अनुरोध करने के लिए इस्तेमाल किए गए OAuth क्लाइंट आईडी के Google Cloud प्रोजेक्ट से जुड़े Classroom ऐड-ऑन अटैचमेंट को बना सकता है या बदल सकता है | CREATE_ADD_ON_ATTACHMENT |
| ग्रेडिंग पीरियड की सेटिंग में बदलाव कर सकता है | UPDATE_GRADING_PERIOD_SETTINGS |
| कोई रूब्रिक बना सकता है, उसमें बदलाव कर सकता है या उसे मिटा सकता है | CREATE_RUBRIC |
इसके बाद, जवाब में मौजूद allowed फ़ील्ड देखें. अगर allowed, true है, तो इसका मतलब है कि उपयोगकर्ता के पास चुने गए Capability का ऐक्सेस है. इसके बाद, उपयोगकर्ता की ओर से Capability से जुड़े एपीआई अनुरोध किए जा सकते हैं.