इस पेज पर, अटैचमेंट बनाने और छात्र-छात्राओं के सबमिट किए गए असाइनमेंट के साथ काम करने के बारे में बताया गया है. ध्यान दें कि ये अनुरोध करते समय, आपको अटैचमेंट से जुड़े पैरामीटर देने पड़ सकते हैं.
अटैचमेंट बनाएं
सही 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
फ़ील्ड का इस्तेमाल करके सेट की गई है. अगर आपके प्रॉडक्ट से शिक्षकों को किसी गतिविधि के लिए छात्र/छात्रा के स्कोर में बदलाव करने की
अनुमति मिलती है, तो ज़रूरत पड़ने पर इस वैल्यू को अपडेट करें.