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

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

कोई अटैचमेंट बनाना

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

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

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

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

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

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

उपयोगकर्ता के क्रेडेंशियल और भूमिका की पुष्टि करना

छात्र-छात्रा के तौर पर दिखने वाला iframe, छात्र-छात्रा के काम की समीक्षा करने वाला iframe, और शिक्षक के तौर पर दिखने वाला iframe, इन सभी का मकसद उपयोगकर्ता को कॉन्टेंट दिखाना है. इनका इस्तेमाल Classroom असाइनमेंट में बदलाव करने के लिए नहीं किया जाता. इनमें से कोई व्यू खुलने पर, ये काम किए जा सकते हैं:

• उपयोगकर्ता के लिए OAuth क्रेडेंशियल पाएं.
• उपयोगकर्ता की भूमिका की पुष्टि करने के लिए, courseWork.getAddOnContext, courseWorkMaterials.getAddOnContext या announcements.getAddOnContext अनुरोध करें.itemType
• जवाब की जांच करें. देखें कि जवाब में 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 को ग्रेड दिया जा सकता है: पहला, जब छात्र-छात्रा अपना काम पूरा कर लेता है. दूसरा, जब शिक्षक, छात्र-छात्रा के काम को Student Work Review iframe में खोलता है.

अगर आपको छात्र-छात्रा के काम पूरा करने पर ग्रेड सेट करने हैं, तो आपको शिक्षक के ऑफ़लाइन क्रेडेंशियल सेव करने होंगे. इसके बाद, छात्र-छात्रा के काम पूरा करने पर, ग्रेड में बदलाव करने के लिए इन क्रेडेंशियल को वापस पाना होगा और इनका इस्तेमाल करना होगा. इस तरीके से ये फ़ायदे मिल सकते हैं:

• ग्रेड को आसानी से अपडेट किया जा सकता है. Classroom के यूज़र इंटरफ़ेस (यूआई) में ग्रेड अपने-आप दिखने लगते हैं. इसके लिए, शिक्षकों को कोई खास कार्रवाई करने की ज़रूरत नहीं होती.
• किसी क्लास के छात्र-छात्राओं की असाइनमेंट से जुड़ी प्रोग्रेस के बारे में रीयल-टाइम में अहम जानकारी मिलती है. छात्र-छात्राओं के अटैचमेंट पूरे करने पर ग्रेड सेट करके, शिक्षक यह जान सकते हैं कि छात्र-छात्राओं को कितना समझ आया. इसके लिए, उन्हें हर सबमिशन खोलने की ज़रूरत नहीं होती.

ध्यान दें कि इस तरीके से, ग्रेड सिंक करने के लिए एसिंक्रोनस तरीके का इस्तेमाल भी किया जा सकता है. छात्र-छात्रा ने अपना काम कब सबमिट किया है, यह पता लगाने के लिए समय-समय पर AddOnAttachmentStudentSubmission एंडपॉइंट को पोल किया जा सकता है. सबमिट होने के बाद, सेव किए गए क्रेडेंशियल का इस्तेमाल करके सबमिशन का ग्रेड सेट करें.

अगर आपको छात्र-छात्राओं के सेशन के दौरान शिक्षक के क्रेडेंशियल लोड नहीं करने हैं, तो छात्र-छात्राओं के काम की समीक्षा करने वाले iframe में छात्र-छात्राओं के सबमिट किए गए काम को लोड करते समय, सक्रिय शिक्षक के क्रेडेंशियल का इस्तेमाल किया जा सकता है. हालांकि, इससे लोगों को बेहतर अनुभव नहीं मिल सकता, क्योंकि Classroom के यूज़र इंटरफ़ेस (यूआई) में ग्रेड रीयल टाइम में अपडेट नहीं होते. साथ ही, शिक्षकों को हर सबमिशन के छात्र-छात्राओं के काम की समीक्षा करने वाले iframe को खोलना होगा.

असाइनमेंट के ग्रेड में हुए बदलावों का पता लगाना

असाइनमेंट बनाने के बाद, शिक्षक Classroom में ग्रेड की सेटिंग में बदलाव कर सकते हैं. इस तरह के बदलावों में ये शामिल हो सकते हैं:

• असाइन किए गए पॉइंट की वैल्यू बदलना.
• असाइनमेंट की maxPoints वैल्यू बदलना.
• यह तय करना कि असाइनमेंट को ग्रेड दिया जाना चाहिए या नहीं.

किसी असाइनमेंट की ग्रेडिंग की मौजूदा सेटिंग देखने के लिए, हमारा सुझाव है कि आप courses.courseWork एंडपॉइंट को GET अनुरोध भेजें. जवाब में, maxPoints की मौजूदा वैल्यू शामिल होती है. बिना ग्रेड वाले असाइनमेंट की maxPoints वैल्यू शून्य होती है.

अगर आपने Classroom में ग्रेड वापस भेज दिया है, तो ऐड-ऑन अटैचमेंट के लिए ग्रेड पाने या उसमें बदलाव करने के लिए, courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट का इस्तेमाल करें. ग्रेड की वैल्यू, pointsEarned फ़ील्ड का इस्तेमाल करके सेट की जाती है. अगर आपका प्रॉडक्ट, शिक्षकों को किसी गतिविधि के लिए छात्र-छात्रा के स्कोर में बदलाव करने की अनुमति देता है, तो इस वैल्यू की जांच करें और अगर ज़रूरी हो, तो इसे अपडेट करें.