अटैचमेंट के साथ इंटरैक्ट करना

इस पेज पर, अटैचमेंट बनाने और छात्र-छात्राओं के सबमिट किए गए दस्तावेज़ों के साथ काम करने के बारे में जानकारी दी गई है. ध्यान दें कि ये अनुरोध करते समय, आपको अटैचमेंट से जुड़े पैरामीटर देने पड़ सकते हैं.

अटैचमेंट बनाना

सही courses.*.addOnAttachments.create एंडपॉइंट पर CREATE अनुरोध करके, अटैचमेंट बनाएं. आपके अनुरोध के मुख्य हिस्से में, AddOnAttachment का एक उदाहरण शामिल होना चाहिए.

अटैचमेंट बनाते समय, इन फ़ील्ड में जानकारी देना ज़रूरी है:

  • title: अटैचमेंट का स्ट्रिंग नाम.
  • teacherViewUri: अटैचमेंट के टीचर व्यू का यूआरआई.
  • studentViewUri: अटैचमेंट के स्टूडेंट व्यू का यूआरआई.
  • studentWorkReviewUri: अटैचमेंट पर छात्र/छात्रा के काम को देखने के लिए, शिक्षक का यूआरआई. यह फ़ील्ड सिर्फ़ गतिविधि के टाइप के अटैचमेंट के लिए ज़रूरी है.

आपके पास इनमें से कुछ वैकल्पिक फ़ील्ड शामिल करने का विकल्प है:

  • dueDate और dueTime, अगर अटैचमेंट सबमिट करने की समयसीमा तय की गई है.
  • maxPoints: अटैचमेंट के लिए ज़्यादा से ज़्यादा ग्रेड. अगर आपको ग्रेड पासबैक की सुविधा देनी है, तो ज़रूरी है कि यह वैल्यू शून्य न हो. यह सिर्फ़ गतिविधि से जुड़े अटैचमेंट पर लागू होता है.

इन फ़ील्ड के बारे में ज़्यादा जानकारी के लिए, AddOnAttachment रिसॉर्स रेफ़रंस देखें.

छात्र/छात्रा के सबमिशन की जानकारी

सबमिशन का सामान्य वर्कफ़्लो इस तरह होता है:

  1. कोई छात्र किसी गतिविधि को पूरा करने के लिए, studentViewUri को लॉन्च करता है.
  2. ऐड-ऑन, छात्र-छात्राओं के क्रेडेंशियल का इस्तेमाल करके, getAddOnContext तरीके से submissionId को वापस लाता है.
  3. submissionId और attachmentId को ऐड-ऑन डेवलपर, छात्र के काम के यूनीक आइडेंटिफ़ायर के तौर पर सेव करता है. अगर कोई शिक्षक, Classroom में किसी असाइनमेंट को कॉपी करता है, तो कॉपी किए गए असाइनमेंट में नया अटैचमेंट दिखाने के लिए, इन दोनों पैरामीटर की कंपोजिट कुंजी का इस्तेमाल किया जा सकता है. ज़्यादा जानकारी के लिए, कॉपी किए गए कॉन्टेंट के बारे में हमारा पेज देखें.
  4. छात्र-छात्राओं के काम की समीक्षा करने के लिए, कोई शिक्षक studentWorkReviewUri को लॉन्च करता है. अनुरोध में ये क्वेरी पैरामीटर शामिल हैं: courseId, itemId, itemType, attachmentId, और submissionId.
  5. ऐड-ऑन डेवलपर, छात्र-छात्राओं के काम को वापस पाने के लिए इन चार आईडी का इस्तेमाल करता है. छात्र/छात्रा के सबमिट किए गए असाइनमेंट की जानकारी पाने या उसमें बदलाव करने के लिए, 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 फ़ील्ड का इस्तेमाल करके सेट की जाती है. अगर आपके प्रॉडक्ट से शिक्षकों को किसी गतिविधि के लिए छात्र/छात्रा के स्कोर में बदलाव करने की अनुमति मिलती है, तो ज़रूरत पड़ने पर इस वैल्यू को अपडेट करें.