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

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

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

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

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

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

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

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

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

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