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

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

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

CREATE अनुरोध जारी करके अटैचमेंट बनाएं courses.*.addOnAttachments.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 एंडपॉइंट छात्र/छात्रा के सबमिट किए गए असाइनमेंट से जुड़ी जानकारी को वापस पा सकता है या उसमें बदलाव कर सकता है.

सबमिशन स्थिति का पता लगाएं

इसके लिए एक GET अनुरोध जारी करें: पाने के लिए courses.courseWork.addOnAttachments.studentSubmissions एंडपॉइंट किसी submissionId के बारे में जानकारी. आपको AddOnAttachmentStudentSubmission ऑब्जेक्ट, जिसमें सबमिशन का ग्रेड शामिल है (pointsEarned) और मौजूदा स्थिति (postSubmissionState). सबमिशन की स्थिति इनमें से कोई एक वैल्यू हो सकती है:

  • NEW, अगर छात्र/छात्रा ने सबमिट किए गए असाइनमेंट को कभी ऐक्सेस नहीं किया है.
  • अगर छात्र/छात्रा ने असाइनमेंट बनाया है, लेकिन उसे अभी तक सबमिट नहीं किया है, तो CREATED.
  • TURNED_IN, अगर छात्र/छात्रा ने अपना काम शिक्षक को सबमिट किया है.
  • RETURNED, अगर शिक्षक ने छात्र/छात्रा को असाइनमेंट वापस कर दिया हो.
  • RECLAIMED_BY_STUDENT, अगर छात्र/छात्रा ने "सबमिट नहीं किया है" उनका काम.

ऐड-ऑन में छात्र/छात्रा के काम की स्थिति का पता लगाने के लिए, इस एंडपॉइंट का इस्तेमाल करें. आपने लोगों तक पहुंचाया मुफ़्त में बदल सकता है. इसके बाद, राज्य के तौर पर वापस किया गया. इसमें ये सुविधाएं शामिल हो सकती हैं:

  • आपके ऐड-ऑन में, असाइनमेंट के सबमिट होने की स्थिति दिखाई जा रही है. यह हो सकता है छात्र-छात्राओं को संभावित भ्रम से बचने में मदद करते हैं. साथ ही, पक्का करते हैं कि कहीं वे गलती से न देख लें असाइनमेंट सबमिट नहीं कर पाए.
  • सबमिशन में बदलाव करने के खास अधिकारों को प्रतिबंधित किया जा रहा है. अगर असाइनमेंट की स्थिति है CREATED या RECLAIMED_BY_STUDENT, छात्र/छात्रा में बदलाव करने की अनुमति हो सकती है सबमिट नहीं कर पाएंगे. अगर असाइनमेंट की स्थिति TURNED_IN या RETURNED है, तो ऐसा हो सकता है कि छात्र/छात्रा को अपने सबमिशन में बदलाव करने की अनुमति न हो.

ग्रेड और एक से ज़्यादा अटैचमेंट

किसी एक का ग्रेड सेट करने के लिए, सिर्फ़ एक ऐड-ऑन अटैचमेंट का इस्तेमाल किया जा सकता है असाइनमेंट चुनें. अगर कोई शिक्षक एक से ज़्यादा गतिविधि-टाइप के अटैचमेंट बनाता है maxPoints मान देता है, सिर्फ़ पहला अटैचमेंट ही असाइनमेंट ग्रेड maxPoints की वैल्यू को सेट न करें या इसे शून्य पर सेट करें अटैचमेंट के लिए ग्रेड पासबैक बंद कर दें.

सबमिशन का ग्रेड सेट करना

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