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

Classroom में असाइनमेंट को CourseWork आइटम कहा जाता है. ये किसी भी 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 में जाकर किसी भी असाइनमेंट में अपना काम जोड़ सकते हैं.

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

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

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

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

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

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

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

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