उपयोगकर्ता के लिए ज़रूरी शर्तें

Google Classroom API के लिए अनुरोध करने का अधिकार हर डेवलपर के पास होता है. हालांकि, Google Classroom की कुछ सुविधाएं सिर्फ़ कुछ उपयोगकर्ताओं के लिए उपलब्ध हैं. हर सुविधा के लिए, अलग-अलग ज़रूरी शर्तें हो सकती हैं. जैसे, Google Workspace for Education का कोई खास लाइसेंस होना. Google Workspace for Education के हर लाइसेंस लेवल पर मिलने वाली सुविधाओं के बारे में ज़्यादा जानने के लिए, वर्शन की तुलना करने वाला पेज देखें.

मुख्य शब्द: ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ता के पास, Classroom की किसी सुविधा का इस्तेमाल करने की क्षमता होती है.

खास जानकारी: हर उपयोगकर्ता के लिए, सुविधा का इस्तेमाल करने की क्षमता अलग-अलग तय की जाती है. साथ ही, यह समय के साथ बदल सकती है.

ज़रूरी शर्तें पूरी करने पर मिलने वाली सुविधाएं

Classroom API की ये सुविधाएं, सिर्फ़ ज़रूरी शर्तें पूरी करने वाले उपयोगकर्ताओं के लिए उपलब्ध हैं:

• Classroom ऐड-ऑन के अटैचमेंट बनाना
• ग्रेडिंग पीरियड की सेटिंग में बदलाव करना
• रूब्रिक बनाना, अपडेट करना, और मिटाना

उपयोगकर्ता की क्षमताओं का पता लगाना

Classroom API को भेजे जाने वाले अनुरोध, अलग-अलग उपयोगकर्ताओं की ओर से किए जाते हैं. इसलिए, ज़रूरी शर्तों के साथ एपीआई अनुरोध जारी करने से पहले, आपको यह देखना चाहिए कि उपयोगकर्ता के पास ज़रूरी सुविधाएं हैं या नहीं.

अहम जानकारी: उपयोगकर्ता की क्षमताओं की पहले से जांच करें, ताकि आप अपने प्रॉडक्ट के दिखने या काम करने के तरीके को Classroom की उन सुविधाओं के हिसाब से बना सकें जिन्हें वे ऐक्सेस कर सकते हैं.

यह पता करने के लिए कि किसी उपयोगकर्ता के पास कोई खास सुविधा है या नहीं, checkUserCapability तरीके के लिए एपीआई अनुरोध करें. Classroom की जिस सुविधा का इस्तेमाल करना है उसके लिए सही Capability टाइप शामिल करें. हर सुविधा के लिए सही Capability बताएं:

यह देखने के लिए कि उपयोगकर्ता...	Capability
आपके पास उस Classroom ऐड-ऑन का ऐक्सेस हो जिसका मालिकाना हक, अनुरोध करने वाले Google Cloud प्रोजेक्ट के पास है	CREATE_ADD_ON_ATTACHMENT
ग्रेडिंग पीरियड की सेटिंग में बदलाव कर सकते हैं	UPDATE_GRADING_PERIOD_SETTINGS
किसी रूब्रिक को बनाया जा सकता है या उसमें बदलाव किया जा सकता है	CREATE_RUBRIC

इसके बाद, जवाब में allowed फ़ील्ड को चुनें. अगर allowed, true है, तो इसका मतलब है कि उपयोगकर्ता के पास चुने गए Capability का ऐक्सेस है. इसके बाद, उपयोगकर्ता की ओर से Capability से जुड़े एपीआई अनुरोध किए जा सकते हैं.

अहम जानकारी: भले ही, कोई उपयोगकर्ता ज़रूरी शर्तें पूरी करता हो, फिर भी ज़रूरी शर्तों पर निर्भर एपीआई अनुरोधों के अस्वीकार होने की संभावना बनी रहती है. ज़रूरी शर्तें पूरी होने का मतलब है कि उपयोगकर्ता, Classroom की किसी सुविधा का इस्तेमाल कर सकता है. इसका मतलब यह नहीं है कि कोई अनुरोध स्वीकार किया जाएगा.