इस पेज पर अटैचमेंट बनाने और छात्र/छात्रा के सबमिशन पर काम करने के तरीके को लागू करने के बारे में जानकारी दी गई है. ध्यान दें कि इस तरह के अनुरोध करते समय, आपको अटैचमेंट से जुड़े पैरामीटर देने की ज़रूरत पड़ सकती है.
अटैचमेंट बनाएं
सही
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के तौर पर शून्य होनी चाहिए. - ऐड-ऑन को अटैचमेंट का मूल रूप से बनाया गया होना चाहिए.
ध्यान दें कि पहले से बनाए गए AddOnAttachment की maxPoints वैल्यू में बदलाव करने के लिए, addOnAttachments एंडपॉइंट पर PATCH अनुरोध जारी किया जा सकता है.
ग्रेड कब सेट करें
आपके पास यह तय करने का विकल्प होता है कि Google Classroom को कोई ग्रेड कब भेजा जाए. अहम अंतर यह है कि क्या शिक्षक के क्रेडेंशियल को सेव किया जाएगा, क्योंकि शिक्षक ही ग्रेड में बदलाव कर सकता है.
ऐसे दो ऐड-ऑन पल होते हैं जिनमें Google Classroom को ग्रेड दिया जा सकता है: जब छात्र/छात्रा अपना काम पूरा करता है या शिक्षक, 'छात्र/छात्रा के काम की समीक्षा' iframe में उसका काम खोलता है.
अगर छात्र/छात्रा के काम पूरा करने के बाद ग्रेड सेट करने हैं, तो आपको शिक्षक के ऑफ़लाइन क्रेडेंशियल सेव करने होंगे. इसके बाद, छात्र/छात्रा के काम पूरा करने के बाद, ग्रेड को वापस पाने के लिए उनका इस्तेमाल करें और ग्रेड में बदलाव करें. इस तरीके से कुछ फ़ायदे हो सकते हैं:
- बिना किसी रुकावट के ग्रेड अपडेट दें. Classroom के यूज़र इंटरफ़ेस (यूआई) में ग्रेड की जानकारी भरने के लिए, शिक्षकों को कोई खास कार्रवाई करने की ज़रूरत नहीं होती.
- असाइनमेंट के ज़रिए क्लास की प्रोग्रेस के बारे में रीयल-टाइम में अहम जानकारी देना. छात्र-छात्राओं के अटैचमेंट पूरा करने के साथ-साथ ग्रेड सेट करने से, शिक्षक हर सबमिशन को खोले बिना ही छात्र-छात्राओं को उनकी समझ का अनुमान लगा सकते हैं.
ध्यान दें कि इस तरीके से ग्रेड सिंक करने के लिए, एसिंक्रोनस तरीका भी अपनाया जा सकता है. छात्र/छात्रा ने अपना काम कब सबमिट किया है, यह जानने के लिए समय-समय पर AddOnAttachmentStudentSubmission एंडपॉइंट पोल का इस्तेमाल किया जा सकता है. सबमिट होने के बाद, सेव किए गए क्रेडेंशियल का इस्तेमाल करके इसका ग्रेड सेट करें.
अगर छात्र-छात्राओं वाले सेशन के दौरान आपको शिक्षक के क्रेडेंशियल लोड नहीं करने हैं, तो आपके पास सक्रिय शिक्षक के क्रेडेंशियल का इस्तेमाल करने का विकल्प है. ऐसा तब होगा, जब वे छात्र-छात्राओं के काम की समीक्षा करने वाले iframe में छात्र-छात्राओं के सबमिट किए गए असाइनमेंट को लोड करेंगे. हालांकि, इससे उपयोगकर्ता अनुभव बेहतर नहीं हो पाएगा, क्योंकि Classroom के यूज़र इंटरफ़ेस (यूआई) में मौजूद ग्रेड, रीयल टाइम में अपडेट नहीं होते. ऐसे में, शिक्षकों को हर सबमिशन के लिए, छात्र-छात्राओं के काम की समीक्षा करने वाले iframe को खोलना होगा.
असाइनमेंट ग्रेड में हुए बदलावों का पता लगाएं
शिक्षक असाइनमेंट बनाने के बाद, Classroom में ग्रेड की सेटिंग में बदलाव कर सकते हैं. ऐसे बदलावों में ये चीज़ें शामिल हो सकती हैं:
- असाइन किए गए पॉइंट की वैल्यू में बदलाव किया जा रहा है.
- असाइनमेंट के
maxPointsकी वैल्यू बदली जा रही है. - यह बदला जा रहा है कि असाइनमेंट पर ग्रेड देना है या नहीं.
किसी असाइनमेंट की मौजूदा ग्रेडिंग सेटिंग देखने के लिए, हमारा सुझाव है कि आप
courses.courseWork एंडपॉइंट पर GET अनुरोध भेजें. रिस्पॉन्स में
मौजूदा maxPoints वैल्यू शामिल होती है. ग्रेड नहीं किए गए असाइनमेंट में, maxPoints की वैल्यू शून्य या शून्य होती है.
अगर आपने Classroom में ग्रेड वापस पास कर दिया है, तो ऐड-ऑन अटैचमेंट के लिए ग्रेड फ़ेच करने या उसमें बदलाव करने के लिए, courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट का इस्तेमाल करें. ग्रेड की वैल्यू को pointsEarned फ़ील्ड का इस्तेमाल करके सेट किया जाता है. अगर आपके प्रॉडक्ट से शिक्षक किसी खास गतिविधि के लिए छात्र/छात्रा के स्कोर में बदलाव कर पाते हैं, तो इसकी जांच करें और अगर ज़रूरी हो, तो इस वैल्यू को अपडेट करें.