अगर आपको Classroom के रूब्रिक के बारे में जानकारी नहीं है, तो सहायता केंद्र के ये लेख पढ़ें. इनसे आपको रूब्रिक के सामान्य स्ट्रक्चर के बारे में पता चलेगा. साथ ही, यह भी पता चलेगा कि Classroom के यूज़र इंटरफ़ेस (यूआई) में रूब्रिक के हिसाब से ग्रेड कैसे दिया जाता है.
रूब्रिक का स्ट्रक्चर
रूब्रिक के साथ इंटरैक्ट करने के लिए एपीआई का इस्तेमाल करते समय, कुछ अहम कॉन्सेप्ट को हाइलाइट करना ज़रूरी हो सकता है:
CourseWork
से जुड़ा एक (ज़्यादा से ज़्यादा) रubric होता है और वहCourseWork
के लिए यूनीक होता है. इसेCourseWork
के सभी संसाधनों के साथ शेयर नहीं किया जा सकता.- रूब्रिक में शर्तें होती हैं, जिनमें लेवल होते हैं. किसी रूब्रिक में कम से कम एक क्राइटेरिया होना चाहिए और किसी क्राइटेरिया में कम से कम एक लेवल होना चाहिए.
- लेवल को स्कोर किया जा सकता है (उनमें पॉइंट होते हैं) या बिना स्कोर के छोड़ा जा सकता है (उनमें कोई पॉइंट नहीं होता). किसी रूब्रिक में, लेवल को पूरी तरह से स्कोर किया जाना चाहिए या पूरी तरह से बिना स्कोर के छोड़ा जाना चाहिए.
- अगर लेवल को स्कोर किया जाता है, तो किसी शर्त के सभी लेवल के लिए, पॉइंट की एक यूनीक वैल्यू सेट होनी चाहिए. पॉइंट, पूर्णांक (जैसे, 10) या फ़्लोटिंग पॉइंट वैल्यू (जैसे, 9.99) हो सकते हैं. इसमें 0 भी शामिल हो सकता है. शून्य वैल्यू स्वीकार नहीं की जाती हैं. इसके अलावा, किसी रूब्रिक में एक लेवल के साथ एक ही शर्त नहीं हो सकती, जिसका मतलब है कि 0 पॉइंट.
- अगर लेवल को कोई स्कोर नहीं दिया गया है, तो पॉइंट फ़ील्ड को हटा दिया जाना चाहिए. शून्य वैल्यू स्वीकार नहीं की जाती.
- शर्तों और लेवल का क्रम अहम होता है. यह क्रम, Classroom के यूज़र इंटरफ़ेस (यूआई) में दिखाए जाने वाले क्रम को दिखाता है.
- खास तौर पर, स्कोर वाले लेवल को हमेशा पॉइंट के हिसाब से, बढ़ते या घटते क्रम में क्रम से लगाया जाना चाहिए.
- हर रूब्रिक में ज़्यादा से ज़्यादा 50 शर्तें और हर शर्त के लिए ज़्यादा से ज़्यादा 10 परफ़ॉर्मेंस लेवल हो सकते हैं.
छात्र-छात्राओं के सबमिशन से जुड़े फ़ील्ड
StudentSubmission
ऑब्जेक्ट, रूब्रिक से जुड़े फ़ील्ड के साथ काम करते हैं:
- मौजूदा
draftGrade
औरassignedGrade
प्रॉपर्टी के अलावा, किसी छात्र के सबमिशन को रूब्रिक के हिसाब से ग्रेड देने पर, उसमेंdraftRubricGrades
औरassignedRubricGrades
प्रॉपर्टी शामिल होती हैं. ये, ड्राफ़्ट और असाइन किए गए स्टेटस में, रूब्रिक से ग्रेडिंग के दौरान छात्र को मिले रूब्रिक ग्रेड (चुने गए लेवल और पॉइंट वैल्यू) दिखाते हैं. - फ़िलहाल, इन प्रॉपर्टी को सिर्फ़ पढ़ा जा सकता है. इसका मतलब है कि सबमिट किए गए दस्तावेज़ों को ग्रेड देने के लिए, एपीआई का इस्तेमाल नहीं किया जा सकता. हालांकि, Classroom के यूज़र इंटरफ़ेस (यूआई) में, ग्रेड वाले सबमिट किए गए दस्तावेज़ पढ़े जा सकते हैं.
रूब्रिक के व्यवहार
एपीआई का मकसद, Classroom के यूज़र इंटरफ़ेस (यूआई) को हमेशा एक जैसा रखना है. हालांकि, इससे ऐसा व्यवहार हो सकता है जो डेवलपर के लिए आसान न हो. इस बारे में बताना ज़रूरी है:
- रूब्रिक का मकसद, शिक्षकों को ग्रेड देने के लिए निर्देश देना है. इसलिए, कोई शिक्षक किसी सबमिशन को ग्रेड देते समय, ये काम कर सकता है:
- ग्रेड देते समय रूब्रिक को पूरी तरह अनदेखा करें.
- किसी शर्त के लिए पॉइंट बदलें. भले ही, शर्त के लेवल में उपलब्ध पॉइंट कुछ भी हों.
- सिर्फ़ शर्तों के सबसेट के लिए लेवल चुनें.
- किसी शर्त के लिए पॉइंट असाइन करें, लेकिन उसके लिए कोई लेवल न चुनें.
- असाइनमेंट के कुल पॉइंट बदलें. भले ही, ये पॉइंट, रूब्रिक से मिले हों.
इसके अलावा, एपीआई में ऐसा कोई तरीका काम नहीं करता जो Classroom के यूज़र इंटरफ़ेस में पहले से मौजूद न हो. उदाहरण के लिए, एपीआई की मदद से, असाइनमेंट में रूब्रिक का इस्तेमाल करने की ज़रूरी शर्त लागू नहीं की जा सकती. इसके अलावा, शिक्षक के पास रूब्रिक और सबमिशन में बदलाव करने की सुविधा को बदला भी नहीं जा सकता.
ग्रेडिंग के दौरान आने वाली सीमाएं
इसी तरह, जब कोई शिक्षक रूब्रिक का इस्तेमाल करके ग्रेडिंग शुरू कर देता है, तो उस रूब्रिक में बदलाव करने पर कुछ और पाबंदियां लागू हो जाती हैं. अपग्रेड शुरू होने के बाद, सिर्फ़ इनमें बदलाव किए जा सकते हैं:
- शर्त और लेवल के टाइटल और ब्यौरे में टेक्स्ट में बदलाव करने की अनुमति है.
- शर्तों के हिसाब से, लेवल का क्रम बदल सकता है.
अन्य स्कोप
शिक्षक, फिर से इस्तेमाल करने के लिए, Google स्प्रेडशीट में मैन्युअल तरीके से एक्सपोर्ट कर सकते हैं.
अगर इन स्प्रेडशीट से कोई रूब्रिक बनाया या अपडेट किया जाता है (गाइड में उदाहरण देखें), तो आपके ऐप्लिकेशन को https://www.googleapis.com/auth/spreadsheets.readonly
या https://www.googleapis.com/auth/spreadsheets
स्कोप का अनुरोध करना होगा. ध्यान रखें कि spreadsheets
स्कोप को संवेदनशील माना जाता है. इसलिए, हो सकता है कि आपके ऐप्लिकेशन की पुष्टि की ज़रूरत पड़े.
तीसरे पक्ष का कोर्सवर्क
रूब्रिक सिर्फ़ उस Google Cloud प्रोजेक्ट से बनाई जा सकती है जिसने पेरंट
CourseWork
आइटम बनाया है. यह Classroom API का एक बड़ा डिज़ाइन पैटर्न है. इससे अलग-अलग ऐप्लिकेशन, उन संसाधनों पर असर नहीं डाल पाते जो उनके नहीं हैं.
यह सुविधा, Classroom ऐप्लिकेशन में उपयोगकर्ताओं के बनाए गए संसाधनों पर भी लागू होती है. उदाहरण के लिए, कोई ऐप्लिकेशन, किसी कोर्सवर्क के लिए बनाए गए रूब्रिक को मैनेज नहीं कर सकता. भले ही, उस कोर्सवर्क को बनाने वाले शिक्षक के पास ऐप्लिकेशन का मालिकाना हक हो. अगर इससे आपके इस्तेमाल के उदाहरण का दायरा काफ़ी सीमित हो जाता है, तो सार्वजनिक समस्या को ट्रैक करने वाले टूल में सुझाव, शिकायत या राय दें.
लाइसेंस से जुड़ी ज़रूरी शर्तें
कोई उपयोगकर्ता, Classroom API की मदद से सिर्फ़ तब रूब्रिक बना सकता है, अपडेट कर सकता है, और मिटा सकता है, जब ये शर्तें पूरी हों:
- अनुरोध करने वाले उपयोगकर्ता के पास Google Workspace for Education Plus का लाइसेंस हो.
- उस कोर्स के मालिक के पास Google Workspace for Education Plus का लाइसेंस हो.
एपीआई की सुविधाओं को उपयोगकर्ताओं के लिए उपलब्ध कराने के तरीके और Classroom API के ज़रूरी शर्तों के बारे में ज़्यादा जानने के लिए, उपयोगकर्ता की ज़रूरी शर्तें देखें. साथ ही, डेवलपमेंट के लिए डेमो खाते का अनुरोध करें.