इस पेज पर, अटैचमेंट बनाने के बारे में जानकारी दी गई है. साथ ही, यह भी बताया गया है कि उपयोगकर्ता के अटैचमेंट खोलने पर, कौनसी कार्रवाइयां की जा सकती हैं. इसके अलावा, छात्र-छात्राओं के सबमिशन के साथ काम करने के बारे में भी जानकारी दी गई है. ध्यान दें कि इन अनुरोधों को सबमिट करते समय, आपको अटैचमेंट से जुड़े पैरामीटर देने पड़ सकते हैं.
अटैचमेंट बनाना
अटैचमेंट बनाने के लिए, सही courses.*.addOnAttachments.create एंडपॉइंट पर CREATE अनुरोध सबमिट करें. आपके अनुरोध के मुख्य भाग में, AddOnAttachment का कोई इंस्टेंस शामिल होना चाहिए.
अटैचमेंट बनाते समय, इन फ़ील्ड में जानकारी डालना ज़रूरी है:
title: अटैचमेंट का स्ट्रिंग नाम.teacherViewUri: अटैचमेंट के शिक्षक के लिए व्यू का यूआरआई.studentViewUri: अटैचमेंट के छात्र-छात्रा के लिए व्यू का यूआरआई.studentWorkReviewUri: छात्र-छात्रा के काम को देखने के लिए, शिक्षक के लिए अटैचमेंट का यूआरआई. यह फ़ील्ड, सिर्फ़ गतिविधि के टाइप वाले अटैचमेंट के लिए ज़रूरी है.
इन वैकल्पिक फ़ील्ड में से कुछ को शामिल किया जा सकता है:
dueDateऔरdueTime, अगर यह बताया जा रहा है कि अटैचमेंट कब सबमिट करना है.maxPoints: अटैचमेंट के लिए ज़्यादा से ज़्यादा ग्रेड. अगर आपको ग्रेड पासबैक की सुविधा देनी है, तो इसकी वैल्यू शून्य नहीं होनी चाहिए. यह सिर्फ़ गतिविधि के टाइप वाले अटैचमेंट पर लागू होता है.
इन फ़ील्ड के बारे में ज़्यादा जानने के लिए, AddOnAttachment संसाधन का रेफ़रंस देखें.
उपयोगकर्ता के क्रेडेंशियल और भूमिका की पुष्टि करना
छात्र-छात्रा के लिए व्यू वाला iframe, छात्र-छात्रा के काम की समीक्षा करने वाला iframe, और शिक्षक के लिए व्यू वाला iframe तीनों का मकसद उपयोगकर्ता को कॉन्टेंट दिखाना है. इनका इस्तेमाल, Classroom के असाइनमेंट में बदलाव करने के लिए नहीं किया जाता. इनमें से कोई भी व्यू खुलने पर, यह काम करें:
- उपयोगकर्ता के लिए OAuth क्रेडेंशियल हासिल करें.
- उपयोगकर्ता की भूमिका की पुष्टि करने के लिए,
itemTypeके आधार परcourseWork.getAddOnContext,courseWorkMaterials.getAddOnContextयाannouncements.getAddOnContextअनुरोध सबमिट करें. - यह देखने के लिए, जवाब की जांच करें कि उसमें
TeacherContextयाStudentContextमौजूद है या नहीं. इनमें से सिर्फ़ एक को वापस किया जा सकता है. यह कोर्स में उपयोगकर्ता की भूमिका के हिसाब से तय होता है. - अगर मौजूदा उपयोगकर्ता छात्र या छात्रा है और
itemTypeकी वैल्यूcourseWorkहै, तो छात्र-छात्रा के काम के साथ, जवाब में मौजूदsubmissionIdको रिकॉर्ड करें. ऐड-ऑन iframe मेंsubmissionIdsएक जैसे होते हैं. ग्रेड पासबैक के लिए और ग्रेडिंग टूल में शिक्षकों को छात्र-छात्रा का काम दिखाने के लिए, इनकी ज़रूरत होती है. - अगर ऐड-ऑन को
attachmentIdके बारे में पहले से पता है, तो सही अटैचमेंट यूज़र इंटरफ़ेस (यूआई) दिखाएं. - इसके अलावा, इस अटैचमेंट को किसी अन्य स्ट्रीम आइटम या कोर्स से कॉपी किया गया होगा. इस स्थिति के बारे में सुझाव पाने के लिए, कॉपी किए गए कॉन्टेंट को मैनेज करने से जुड़ा लेख देखें.
छात्र-छात्रा के सबमिशन की जानकारी
सबमिशन के लिए आम तौर पर यह वर्कफ़्लो इस्तेमाल किया जाता है:
- कोई छात्र या छात्रा, किसी गतिविधि को पूरा करने के लिए
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वैल्यू बदलना. - यह तय करना कि असाइनमेंट को ग्रेड देना है या नहीं.
किसी असाइनमेंट की मौजूदा ग्रेडिंग सेटिंग देखने के लिए, हमारा सुझाव है कि आप
GET अनुरोध को courses.courseWork एंडपॉइंट पर सबमिट करें. जवाब में, मौजूदा maxPoints वैल्यू शामिल होती है. बिना ग्रेड वाले असाइनमेंट में, maxPoints की वैल्यू शून्य होती है या यह वैल्यू सेट नहीं होती.
अगर आपने Classroom को ग्रेड पासबैक किया है, तो ऐड-ऑन अटैचमेंट के लिए ग्रेड फ़ेच करने या उसमें बदलाव करने के लिए, courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट का इस्तेमाल करें. pointsEarned फ़ील्ड का इस्तेमाल करके, ग्रेड की वैल्यू सेट की जाती है. अगर आपका प्रॉडक्ट, शिक्षकों को किसी खास गतिविधि के लिए छात्र-छात्रा के स्कोर में बदलाव करने की अनुमति देता है, तो इस वैल्यू की जांच करने और ज़रूरत पड़ने पर इसे अपडेट करने पर विचार करें.