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

संग्रह की मदद से व्यवस्थित रहें अपनी प्राथमिकताओं के आधार पर, कॉन्टेंट को सेव करें और कैटगरी में बांटें.

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

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

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

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

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

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