इस पेज पर, अटैचमेंट बनाने और छात्र-छात्राओं के सबमिट किए गए दस्तावेज़ों के साथ काम करने के बारे में जानकारी दी गई है. ध्यान दें कि ये अनुरोध करते समय, आपको अटैचमेंट से जुड़े पैरामीटर देने पड़ सकते हैं.
अटैचमेंट बनाना
सही courses.*.addOnAttachments.create एंडपॉइंट पर CREATE अनुरोध भेजकर, अटैचमेंट बनाएं. आपके अनुरोध के मुख्य हिस्से में, AddOnAttachment का एक उदाहरण शामिल होना चाहिए.
अटैचमेंट बनाते समय, इन फ़ील्ड में जानकारी देना ज़रूरी है:
title: अटैचमेंट का स्ट्रिंग नाम.teacherViewUri: अटैचमेंट के टीचर व्यू का यूआरआई.studentViewUri: अटैचमेंट के स्टूडेंट व्यू का यूआरआई.studentWorkReviewUri: अटैचमेंट में छात्र का काम देखने के लिए, शिक्षक का यूआरआई. यह फ़ील्ड सिर्फ़ गतिविधि के टाइप के अटैचमेंट के लिए ज़रूरी है.
आपके पास इनमें से कुछ वैकल्पिक फ़ील्ड शामिल करने का विकल्प है:
dueDateऔरdueTime, अगर अटैचमेंट सबमिट करने की समयसीमा तय की गई है.maxPoints: अटैचमेंट के लिए ज़्यादा से ज़्यादा ग्रेड. अगर आपको ग्रेड पासबैक की सुविधा का इस्तेमाल करना है, तो यह वैल्यू शून्य से ज़्यादा होनी चाहिए. यह सिर्फ़ गतिविधि के टाइप वाले अटैचमेंट पर लागू होता है.
इन फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, AddOnAttachment रिसॉर्स रेफ़रंस देखें.
छात्र/छात्रा के सबमिशन की जानकारी
सबमिशन का सामान्य वर्कफ़्लो इस तरह होता है:
- कोई छात्र गतिविधि पूरी करने के लिए,
studentViewUriको लॉन्च करता है. - ऐड-ऑन, छात्र/छात्रा के क्रेडेंशियल का इस्तेमाल करके,
getAddOnContextतरीके सेsubmissionIdको वापस लाता है. submissionIdऔरattachmentIdको ऐड-ऑन डेवलपर, छात्र के काम के यूनीक आइडेंटिफ़ायर के तौर पर सेव करता है. अगर कोई शिक्षक, Classroom में किसी असाइनमेंट को कॉपी करता है, तो कॉपी किए गए असाइनमेंट में नया अटैचमेंट दिखाने के लिए, इन दोनों पैरामीटर की कंपोजिट कुंजी का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, कॉपी किए गए कॉन्टेंट से जुड़ा हमारा पेज देखें.- छात्र-छात्राओं के काम की समीक्षा करने के लिए, शिक्षक
studentWorkReviewUriको लॉन्च करता है. अनुरोध में ये क्वेरी पैरामीटर शामिल हैं:courseId,itemId,itemType,attachmentId, औरsubmissionId. - ऐड-ऑन डेवलपर, छात्र-छात्राओं के काम को वापस पाने के लिए इन चार आईडी का इस्तेमाल करता है. छात्र/छात्रा के सबमिट किए गए असाइनमेंट की जानकारी पाने या उसमें बदलाव करने के लिए,
courses.courseWork.addOnAttachments.studentSubmissionsएंडपॉइंट का इस्तेमाल करें.
सबमिशन की स्थिति का पता लगाना
किसी खास submissionId के बारे में जानकारी पाने के लिए, courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट पर GET अनुरोध करें. आपको एक AddOnAttachmentStudentSubmission ऑब्जेक्ट मिलता है, जिसमें सबमिशन का ग्रेड (pointsEarned) और मौजूदा स्थिति (postSubmissionState) शामिल होती है. सबमिशन की स्थिति, इनमें से कोई एक वैल्यू हो सकती है:
NEW, अगर छात्र ने सबमिशन को कभी ऐक्सेस नहीं किया है.CREATED, अगर छात्र ने सबमिशन बनाया है, लेकिन उसे अभी तक सबमिट नहीं किया है.TURNED_IN, अगर छात्र ने अपना काम शिक्षक को सबमिट कर दिया है.RETURNED, अगर शिक्षक ने छात्र/छात्रा को सबमिट किया गया असाइनमेंट लौटा दिया है.RECLAIMED_BY_STUDENT, अगर छात्र ने अपना काम "सबमिट नहीं किया है".
अपने ऐड-ऑन में छात्र-छात्रा के काम की स्थिति का पता लगाने के लिए, इस एंडपॉइंट का इस्तेमाल करें. इसके बाद, आपको छात्र को दिए गए व्यू या विकल्पों में बदलाव करना पड़ सकता है. यह बदलाव, रिटर्न किए गए स्टेटस के हिसाब से किया जाता है. इसमें ये सुविधाएं शामिल हो सकती हैं:
- आपके ऐड-ऑन में, असाइनमेंट सबमिट करने का स्टेटस दिखाना. इससे, छात्र-छात्राओं को असाइनमेंट सबमिट करने में होने वाली संभावित गड़बड़ियों से बचने में मदद मिलती है. साथ ही, यह भी पक्का किया जा सकता है कि वे गलती से कोई असाइनमेंट सबमिट न कर पाएं.
- सबमिशन में बदलाव करने की अनुमतियों पर पाबंदी लगाना. अगर असाइनमेंट का स्टेटस
CREATEDयाRECLAIMED_BY_STUDENTहै, तो छात्र/छात्रा को सबमिट किए गए असाइनमेंट में बदलाव करने की अनुमति दी जा सकती है. अगर असाइनमेंट का स्टेटसTURNED_INयाRETURNEDहै, तो हो सकता है कि छात्र/छात्रा को सबमिट किए गए असाइनमेंट में बदलाव करने की अनुमति न मिले.
ग्रेड और एक से ज़्यादा अटैचमेंट
किसी एक असाइनमेंट के लिए ग्रेड सेट करने के लिए, सिर्फ़ एक ऐड-ऑन अटैचमेंट का इस्तेमाल किया जा सकता है. अगर कोई शिक्षक maxPoints वैल्यू देने वाली गतिविधि के एक से ज़्यादा अटैचमेंट बनाता है, तो सिर्फ़ पहला अटैचमेंट असाइनमेंट का ग्रेड सेट कर सकता है. अटैचमेंट के लिए ग्रेड पासबैक की सुविधा बंद करने के लिए, maxPoints वैल्यू को सेट न करें या उसे शून्य पर सेट करें.
सबमिशन का ग्रेड सेट करना
courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट पर PATCH अनुरोध भेजकर, छात्र/छात्रा के सबमिशन में बदलाव किया जा सकता है. अनुरोध के मुख्य भाग में, बदली गई वैल्यू के साथ AddOnAttachmentStudentSubmission का एक उदाहरण शामिल होना चाहिए. सबमिशन के ग्रेड में बदलाव करने के लिए, pointsEarned फ़ील्ड सेट करें.
pointsEarned में दी गई वैल्यू, ड्राफ़्ट ग्रेड बन जाती है. यह वैल्यू, Classroom के यूज़र इंटरफ़ेस (यूआई) में शिक्षक को दिखती है. शिक्षक, छात्र-छात्राओं को असाइनमेंट वापस करने से पहले, ड्राफ़्ट में दिए गए ग्रेड में बदलाव कर सकते हैं. शिक्षकों को ग्रेड कैसे दिखाए जाते हैं, इस बारे में जानने के लिए Classroom के यूज़र इंटरफ़ेस (यूआई) में ग्रेडिंग की खास जानकारी लेख पढ़ें.
ध्यान दें कि pointsEarned की मदद से ग्रेड सिर्फ़ तब सेट किया जा सकता है, जब ये बातें सही हों:
- अटैचमेंट की
maxPointsवैल्यू पॉज़िटिव होनी चाहिए. - ऐड-ऑन ने ही अटैचमेंट बनाया हो.
यह भी ध्यान दें कि addOnAttachments एंडपॉइंट को PATCH अनुरोध भेजकर, पहले से बनाए गए AddOnAttachment की maxPoints वैल्यू में बदलाव किया जा सकता है.
ग्रेड कब सेट करें
आपके पास यह तय करने का विकल्प होता है कि ग्रेड को Google Classroom में कब भेजा जाए. सबसे अहम बात यह है कि आपने शिक्षक के क्रेडेंशियल सेव करने का विकल्प चुना है या नहीं. ऐसा इसलिए, क्योंकि सिर्फ़ शिक्षक ही ग्रेड में बदलाव कर सकता है.
Google Classroom में ग्रेड देने के लिए, दो ऐड-ऑन मोमेंट हैं: जब छात्र अपना काम पूरा करता है या जब शिक्षक, छात्र के काम की समीक्षा करने वाले iframe में छात्र का काम खोलता है.
अगर आपको छात्र के काम पूरा होने पर ग्रेड सेट करने हैं, तो आपको शिक्षक के ऑफ़लाइन क्रेडेंशियल सेव करने होंगे. इसके बाद, छात्र के काम पूरा होने पर, ग्रेड में बदलाव करने के लिए उन्हें वापस लाकर उनका इस्तेमाल करना होगा. इस तरीके से ये फ़ायदे मिल सकते हैं:
- ग्रेड को आसानी से अपडेट करने की सुविधा. Classroom के यूज़र इंटरफ़ेस (यूआई) में ग्रेड अपने-आप दिखने लगते हैं. इसके लिए, शिक्षकों को कोई खास कार्रवाई करने की ज़रूरत नहीं होती.
- असाइनमेंट की मदद से, क्लास की प्रोग्रेस के बारे में रीयल-टाइम में अहम जानकारी दें. छात्र-छात्राओं के अटैचमेंट सबमिट करने पर ग्रेड सेट करने की सुविधा से, शिक्षकों को हर सबमिशन खोले बिना, अपने छात्र-छात्राओं की समझ के बारे में पता चल सकता है.
ध्यान दें कि इस तरीके से ग्रेड सिंक करने के लिए, अलग-अलग समय पर काम करने वाले तरीके का भी इस्तेमाल किया जा सकता है. छात्र/छात्रा के काम सबमिट करने का पता लगाने के लिए, समय-समय पर AddOnAttachmentStudentSubmission
एंडपॉइंट को पोल किया जा सकता है. सबमिट करने के बाद, सेव किए गए क्रेडेंशियल का इस्तेमाल करके सबमिशन का ग्रेड सेट करें.
अगर आपको छात्र-छात्रा के सेशन के दौरान, शिक्षक के क्रेडेंशियल लोड नहीं करने हैं, तो छात्र-छात्रा के काम की समीक्षा करने वाले iframe में छात्र-छात्रा का सबमिट किया गया काम लोड करने के दौरान, शिक्षक के मौजूदा क्रेडेंशियल का इस्तेमाल किया जा सकता है. हालांकि, इससे उपयोगकर्ता को बेहतर अनुभव नहीं मिल सकता, क्योंकि Classroom के यूज़र इंटरफ़ेस में ग्रेड रीयल टाइम में अपडेट नहीं होते. साथ ही, शिक्षकों को हर सबमिशन के लिए, छात्र/छात्रा के काम की समीक्षा करने वाला iframe खोलना होगा.
असाइनमेंट के ग्रेड में हुए बदलावों का पता लगाना
असाइनमेंट की मौजूदा ग्रेड सेटिंग देखें.असाइनमेंट बनाने के बाद, शिक्षक Classroom में ग्रेड की सेटिंग में बदलाव कर सकते हैं. इस तरह के बदलावों में ये शामिल हो सकते हैं:
- असाइन किए गए पॉइंट की वैल्यू बदलना.
- किसी असाइनमेंट की
maxPointsवैल्यू बदलना. - यह बदलना कि असाइनमेंट को ग्रेड दिया जाना चाहिए या नहीं.
किसी असाइनमेंट की ग्रेडिंग की मौजूदा सेटिंग देखने के लिए, हमारा सुझाव है कि आप courses.courseWork एंडपॉइंट पर GET अनुरोध भेजें. जवाब में, maxPoints की मौजूदा वैल्यू शामिल होती है. जिस असाइनमेंट को ग्रेड नहीं दिया गया है उसकी maxPoints वैल्यू शून्य या शून्य के बराबर होती है.
अगर आपने Classroom में ग्रेड वापस भेज दिया है, तो ऐड-ऑन के अटैचमेंट के लिए ग्रेड पाने या उसमें बदलाव करने के लिए, courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट का इस्तेमाल करें. ग्रेड की वैल्यू, pointsEarned फ़ील्ड का इस्तेमाल करके सेट की जाती है. अगर आपके प्रॉडक्ट में शिक्षकों को किसी खास गतिविधि के लिए, छात्र/छात्रा के स्कोर में बदलाव करने की अनुमति है, तो इस वैल्यू की जांच करें और ज़रूरत पड़ने पर उसे अपडेट करें.