कोई भी डेवलपर, Google Classroom API को अनुरोध कर सकता है. हालांकि, Google Classroom की कुछ सुविधाएं सिर्फ़ कुछ उपयोगकर्ताओं के लिए उपलब्ध हैं. हर सुविधा के लिए, अलग-अलग ज़रूरी शर्तें हो सकती हैं. जैसे, Google Workspace for Education का कोई खास लाइसेंस होना. Google Workspace for Education के हर लाइसेंस लेवल पर मिलने वाली सुविधाओं के बारे में ज़्यादा जानने के लिए, वर्शन की तुलना करने वाला पेज देखें.
ऐसी सुविधाएं जिनके लिए ज़रूरी शर्तें पूरी करनी होती हैं
Classroom API की ये सुविधाएं, ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं के लिए ही उपलब्ध हैं:
- Classroom ऐड-ऑन के अटैचमेंट बनाना और उनमें बदलाव करना.
- ग्रेडिंग पीरियड की सेटिंग में बदलाव करना.
- रubric बनाना, उनमें बदलाव करना, और उन्हें मिटाना.
उपयोगकर्ता की क्षमताओं का पता लगाना
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 से जुड़े एपीआई अनुरोध किए जा सकते हैं.