शुरुआती जानकारी

Classroom में असाइन किए गए असाइनमेंट को CourseWork आइटम कहा जाता है. इन्हें Classroom के किसी भी कोर्स के क्लासवर्क पेज पर देखा जा सकता है. क्लासवर्क के चार आइटम टाइप हैं, लेकिन इस गाइड में सिर्फ़ “असाइनमेंट” टाइप पर फ़ोकस किया गया है. अगर आपको क्लासवर्क के अन्य टाइप मैनेज करने का तरीका जानना है, तो हमारी क्लासवर्क मैनेज करने की गाइड पढ़ें.

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

यहां हम इन दोनों डेवलपर ऑफ़र के बीच के मुख्य अंतर की समीक्षा करेंगे. खास तौर पर, हम असाइनमेंट को लागू करने और असाइनमेंट की लाइफ़-साइकल के हर चरण में अंतर को समझने के लिए काम करेंगे: असाइनमेंट बनाना, छात्र-छात्राओं को सबमिट करना, और ग्रेडिंग/फ़ीडबैक देना.

असाइनमेंट के लाइफ़ साइकल को समझना

Share बटन और CourseWork API के बीच के अंतर के बारे में जानने से पहले, सबसे पहले यह तय करें कि Classroom के संदर्भ में, किसी असाइनमेंट का लाइफ़ साइकल किसे माना जाता है. इससे आपको यह समझने में मदद मिलेगी कि शिक्षक और छात्र-छात्राएं, Classroom में असाइनमेंट के साथ कैसे इंटरैक्ट करते हैं.

Classroom असाइनमेंट के साथ इंटिग्रेट करते समय, इन पांच मुख्य चरणों का ध्यान रखना होगा:

  1. असाइनमेंट बनाया गया.
  2. असाइनमेंट को छात्र-छात्राओं के साथ शेयर किया जाता है.
  3. छात्र/छात्रा असाइनमेंट पूरा कर लेते हैं.
  4. छात्र/छात्रा, शिक्षक को असाइनमेंट सबमिट कर रहा है.
  5. शिक्षक, असाइनमेंट की समीक्षा करते हैं और असाइनमेंट को ग्रेड देते हैं.

Classroom असाइनमेंट को इंटिग्रेट करने पर, शिक्षक और छात्र-छात्राएं Classroom और तीसरे पक्ष के ऐप्लिकेशन के बीच आसानी से काम कर सकते हैं. उपयोगकर्ता, असाइनमेंट या छात्र-छात्राओं के सबमिट किए गए असाइनमेंट की जानकारी मैनेज करने के बजाय, आपके ऐप्लिकेशन पर भरोसा कर सकते हैं.

असाइनमेंट के पांच चरणों को दिखाने वाला डायग्राम

लागू करने का तरीका

शेयर बटन और CourseWork API के बीच का अंतर सबसे पहले लागू करना है. डेवलपर के हिसाब से, शेयर बटन, Classroom में कॉन्टेंट शेयर करने का आसान तरीका है. इसमें सिर्फ़ ज़रूरी JavaScript संसाधन और शेयर बटन टैग जोड़ने की ज़रूरत होती है. सबसे आसान फ़ॉर्मैट में, Classroom में शेयर करने वाला बटन इंटिग्रेशन, नीचे दिए गए स्निपेट की तरह दिख सकता है:

<script src="https://apis.google.com/js/platform.js" async defer></script>
<g:sharetoclassroom url="http://url-to-share" size="32"></g:sharetoclassroom>

वहीं, CourseWork API है, Google Classroom API REST API का हिस्सा है. इसके लिए, Google Cloud Console पर एपीआई पासकोड सेट अप और चालू करने होते हैं. साथ ही, एपीआई के साथ इंटिग्रेट करने के सबसे सही तरीके अपनाने होते हैं. अगर आपके प्लैटफ़ॉर्म पर पहले से ही Classroom API की अन्य सुविधाएं इस्तेमाल हो रही हैं, जैसे कि रोस्टरिंग, तो इस सुविधा को लेकर आपकी कोई चिंता नहीं होगी.

असाइनमेंट बनाना और शेयर करना

हालांकि, Share बटन और CourseWork API की मदद से, असाइनमेंट बनाने के वर्कफ़्लो के पहले दो चरणों को पूरा किया जा सकता है. साथ ही, असाइनमेंट बनाने और छात्र-छात्राओं के साथ शेयर करने का भी इस्तेमाल किया जा सकता है. हालांकि, कुछ ऐसे अहम अंतर हैं जिन पर आपको काम करने का विकल्प चुनने से पहले ध्यान देना चाहिए.

मुख्य रूप से, दोनों सलूशन की मदद से Classroom में लिंक या फ़ाइलों को असाइनमेंट के तौर पर पोस्ट किया जा सकता है. यह उन शिक्षकों के लिए एक शक्तिशाली वर्कफ़्लो के रूप में काम करता है जिन्हें Classroom और तीसरे पक्ष के ऐप्लिकेशन के बीच किसी वर्कफ़्लो को कॉपी करके चिपकाने के लिए मजबूर होना पड़ता है. दोनों तरीकों से कॉन्टेंट को असाइनमेंट के तौर पर पोस्ट किया जा सकता है. हालांकि, आपको इस बात पर ध्यान देना चाहिए कि आपके ऐप्लिकेशन को क्लासवर्क के अन्य टाइप की तरह कॉन्टेंट पोस्ट करने की सुविधा देनी है या कोई एलान करने की ज़रूरत भी है.

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

पोस्ट प्रकार शेयर करने का बटन CourseWork एपीआई
Assignment X X
क्विज़ असाइनमेंट
प्रश्न: संक्षिप्त उत्तर X X
सवाल: कई विकल्प वाले सवाल X X
मटीरियल X X
एलान X X

शीर्षक और ब्यौरा जैसी सुविधाओं को दोनों समाधानों के लिए, आपके ऐप्लिकेशन के हिसाब से प्रोग्राम के हिसाब से तय किया जा सकता है. शेयर बटन इंटिग्रेशन की मदद से उपयोगकर्ता, पॉप-अप डायलॉग में पूरा होने की तारीख, विषय, अलग-अलग मोड, और पॉइंट की संख्या जैसे फ़ील्ड सेट कर सकते हैं. हालांकि, उन्हें तीसरे पक्ष के ऐप्लिकेशन से प्रोग्राम के हिसाब से सेट नहीं किया जा सकता. वहीं दूसरी ओर, एपीआई, पढ़ने और लिखने, दोनों के ऐक्सेस के लिए इन सभी फ़ील्ड को दिखाता है.

असाइनमेंट में बदलाव करना

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

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

असाइनमेंट अपने-आप सिंक होने की सुविधा चालू करें

Pub/Sub पुश नोटिफ़िकेशन की मदद से, आपका ऐप्लिकेशन उन सूचनाओं की सदस्यता ले सकता है जिनसे CourseWork आइटम और उससे जुड़े छात्र/छात्रा के सबमिशन में बदलाव होने पर इवेंट ट्रिगर होता है. इससे आपका ऐप्लिकेशन, असाइनमेंट को आसानी से सिंक कर पाता है. ऐसा करने के लिए, Classroom पर कॉन्टेंट अपडेट होने की लगातार जांच करने की ज़रूरत नहीं होती.

असाइनमेंट पूरे करना और सबमिट करना

हर असाइनमेंट, N छात्र-छात्राओं के सबमिशन से जुड़ा होता है. इसमें N उन छात्र-छात्राओं की संख्या है जिन्हें यह असाइनमेंट असाइन किया गया था. दूसरे शब्दों में कहें, तो हर असाइनमेंट के लिए, हर छात्र/छात्रा का सबमिशन होता है. इसे एक यूनीक आईडी से ऐक्सेस किया जा सकता है. ये छात्र-छात्राओं के सबमिशन अपने-आप बनाए जाते हैं और इन्हें आपके ऐप्लिकेशन में, छात्र-छात्राओं के सबमिशन पाएं और 'LIST एंडपॉइंट' की मदद से वापस लाया जा सकता है.

शेयर बटन और CourseWork API, दोनों की मदद से किसी असाइनमेंट के लिए छात्र/छात्रा के सबमिशन में लिंक या फ़ाइलें जोड़ी जा सकती हैं. शेयर बटन इसकी मदद से, शिक्षक के असाइनमेंट बनाने वाले डायलॉग के समान वर्कफ़्लो और studentSubmissions.modifyAttachments endpoint की मदद से, CourseWork API की मदद देता है. हालांकि, एपीआई की अनुमति से जुड़ी पाबंदियों की जानकारी देने की वजह से, यह सुविधा आपके ऐप्लिकेशन के बनाए गए CourseWork आइटम तक ही सीमित है. यह पाबंदी 'शेयर करें' बटन पर भी लागू नहीं होती है. छात्र-छात्राएं Classroom से अपने चुने गए किसी भी असाइनमेंट में अपने काम को जोड़ सकते हैं.

छात्र-छात्राओं के वर्कफ़्लो को बंद किया जा रहा है

CourseWork की अनुमति की पाबंदी उन प्लैटफ़ॉर्म के लिए इस्तेमाल के उदाहरण नहीं है जिन पर असाइनमेंट बनाने की सुविधा काम नहीं करती. हालांकि, इसका एक फ़ायदा यह है कि तीसरे पक्ष के प्लैटफ़ॉर्म, छात्र-छात्राओं को गलत असाइनमेंट सबमिट करने और असाइनमेंट सबमिट करने से रोकने, दोनों को रोक सकते हैं. ऐसा इसलिए होता है, क्योंकि सिर्फ़ शेयर बटन से छात्र-छात्राएं असाइनमेंट सबमिट नहीं कर सकते.

असाइनमेंट की समीक्षा करना और उन्हें ग्रेड देना

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

फ़िलहाल, शेयर करें बटन से ग्रेडिंग और असाइनमेंट वापस करने के लिए कोई विकल्प नहीं मिलता. फ़िलहाल, छात्र-छात्राओं को सबमिट करने पर टिप्पणी करने जैसी सुविधाएं एपीआई की मदद से उपलब्ध नहीं कराई जाती हैं. हालांकि, studentSubmissions.patch और studentSubmissions.return एंडपॉइंट की मदद से छात्र-छात्राओं को ग्रेड देने और ग्रेड देने जैसी सुविधाएं उपलब्ध कराई जा सकती हैं. ग्रेड सिर्फ़ CourseWork के स्ट्रीम आइटम (असाइनमेंट और सवाल के टाइप) के लिए तय किए जा सकते हैं. वे सिर्फ़ न्यूमेरिक के रूप में उपलब्ध हैं और इन्हें ड्राफ़्ट या फ़ाइनल ग्रेड के तौर पर असाइन किया जा सकता है.

अंतर के बारे में खास जानकारी

पिछले सेक्शन में जिन चीज़ों की समीक्षा की गई है उनकी खास जानकारी नीचे दी गई है. यहां दी गई टेबल में, ऊपर बताई गई चार जगहों के लिए, Share बटन और CourseWork API की तुलना की गई है: असाइनमेंट लागू करना, बनाना और शेयर करना, कैटगरी को पूरा करना और सबमिट करना, असाइनमेंट पूरे करना और सबमिट करना, और असाइनमेंट की समीक्षा करना और ग्रेड देना.

शेयर करने का बटन CourseWork एपीआई
लागू करने का तरीका JavaScript की कुछ ही लाइनों की मदद से, लागू करने की प्रोसेस को आसान और तेज़ बनाया जाता है इसके लिए, एपीआई कुंजियां सेट अप करना, Admin console में एपीआई चालू करना, और बारीकी से निगरानी करना ज़रूरी है
असाइनमेंट बनाना और शेयर करना
  • शिक्षकों को Classroom पर रीडायरेक्ट करता है, शेयर करने वाला बटन शेयर करने वाला डायलॉग
  • उपयोगकर्ता एक स्ट्रीम आइटम टाइप को छोड़कर, बाकी सभी आइटम पोस्ट कर सकते हैं
  • कम फ़ील्ड के बारे में बताया जा सकता है
  • एक विकल्प, असाइनमेंट बनाने की सुविधा देता है. हालांकि, असाइनमेंट डेटा को पुल करने या उसमें बदलाव करने की सुविधा नहीं मिलती
  • शेयर करने के लिए ज़रूरी कोई डायलॉग बॉक्स नहीं है
  • Classroom के ज़्यादातर असाइनमेंट फ़ील्ड के बारे में बताया जा सकता है
  • आपके ऐप्लिकेशन के बनाए गए कोर्सवर्क में बदलाव करने की सुविधा
  • इससे आपके ऐप्लिकेशन को, Classroom से असाइनमेंट का सारा डेटा वापस लेने की अनुमति मिलती है
असाइनमेंट पूरे करना और सबमिट करना
  • छात्र-छात्राओं को Classroom पर रीडायरेक्ट करने के लिए, शेयर करने वाले बटन का डायलॉग बॉक्स
  • छात्र-छात्राओं को अपना सबमिशन, Classroom के किसी भी असाइनमेंट में अटैच करने की सुविधा देता है
  • एक विकल्प, सबमिशन अटैचमेंट को चालू करता है. हालांकि, सबमिट किए गए डेटा को पुल करने या उसमें बदलाव करने की सुविधा नहीं मिलती
  • छात्र-छात्राओं को असाइनमेंट सबमिट करने की अनुमति नहीं देता
  • शेयर करने के लिए ज़रूरी कोई डायलॉग बॉक्स नहीं है
  • सिर्फ़ छात्र-छात्राओं को आपके ऐप्लिकेशन से बनाए गए असाइनमेंट के साथ, सबमिट किए गए असाइनमेंट अटैच करने की अनुमति देता है
  • इससे आपके ऐप्लिकेशन को, आपके ऐप्लिकेशन के लिए बनाए गए छात्र-छात्राओं के सबमिशन में बदलाव करने की अनुमति मिलती है
  • छात्र-छात्राओं को उनके असाइनमेंट सबमिट करने की सुविधा देता है
असाइनमेंट की समीक्षा करना और उन्हें ग्रेड देना ग्रेड तय करने या लौटाने की सुविधा नहीं है
  • इससे ऐप्लिकेशन किसी शिक्षक की तरफ़ से, Classroom से छात्र-छात्राओं के सबमिशन का डेटा ले सकता है
  • छात्र-छात्राओं को ड्राफ़्ट या फ़ाइनल ग्रेड देने की सुविधा देता है
  • छात्र-छात्राओं के ग्रेड में बदलाव करने की सुविधा का इस्तेमाल करता है
  • छात्र-छात्राओं को ग्रेड वापस करने की सुविधा देता है