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

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

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

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

असाइनमेंट की लाइफ़साइकल के बारे में जानकारी

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

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

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

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

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

पोस्ट का टाइप शेयर करें बटन CourseWork API
Assignment X X
क्विज़ वाला असाइनमेंट
सवाल: कम शब्दों में जवाब X X
सवाल: कई विकल्प वाला सवाल X X
मटीरियल X X
सूचना X X

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

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

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

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

असाइनमेंट अपने-आप सिंक होना

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

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

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

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

छात्र-छात्राओं के वर्कफ़्लो को खत्म करना

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

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

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

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

अंतरों की खास जानकारी

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

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