CourseWork का इंटिग्रेशन

डेवलपर, Google Classroom API का इस्तेमाल करके Google Classroom में कोर्स के काम से इंटरैक्ट कर सकते हैं. इस तरह से एपीआई का इस्तेमाल करने वाले ऐप्लिकेशन को CourseWork इंटिग्रेशन कहा जाता है.

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

यह कैसे काम करता है

CourseWork इंटिग्रेशन की मुख्य सुविधा यह है कि इसमें Classroom API का इस्तेमाल करके असाइनमेंट, सूचनाएं, और कोर्स के लिए उपलब्ध संसाधन बनाए और मैनेज किए जा सकते हैं.

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

1. जब कोई शिक्षक आपकी वेबसाइट पर साइन इन करता है.
2. शिक्षक को ऐसा कॉन्टेंट मिलता है या वह ऐसा कॉन्टेंट बनाता है जिसे उसे अपनी क्लास के साथ शेयर करना है. शिक्षक, आपकी वेबसाइट पर मौजूद किसी बटन पर क्लिक करके इस कॉन्टेंट को Google Classroom पर भेजता है.
3. आपका ऐप्लिकेशन, courses.courseWork.create को अनुरोध भेजता है. अनुरोध के मुख्य हिस्से में CourseWork ऑब्जेक्ट शामिल है. इसमें ये शामिल हैं:
   • डेस्टिनेशन कोर्स का आईडी.
   • असाइनमेंट का टाइटल.
   • असाइनमेंट के बारे में जानकारी देने वाला टेक्स्ट.
   • link Material, जिसमें शिक्षक के चुने गए कॉन्टेंट का यूआरएल होता है.
   • चुने गए कॉन्टेंट के लिए, ज़्यादा से ज़्यादा स्कोर हासिल किया जा सकता है. हालांकि, यह ज़रूरी नहीं है.
4. Classroom में एक नया असाइनमेंट दिखता है, जिसमें लिंक अटैच होता है. यह लिंक, create अनुरोध में दिए गए यूआरएल से जुड़ा है. उदाहरण के लिए, इमेज 1 देखें.
5. असाइनमेंट के लिए एक नया कॉलम, Classroom के ग्रेडबुक में भी दिखता है. इसमें ज़्यादा से ज़्यादा स्कोर भी शामिल होता है, अगर दिया गया हो.
6. छात्र-छात्राओं को असाइनमेंट मिलता है. इसके बाद, वे link Material पर क्लिक करके, दिए गए यूआरएल को नए टैब में खोलते हैं. इससे वे आपकी वेबसाइट पर मौजूद कॉन्टेंट को देख पाते हैं या उसे पूरा कर पाते हैं. अगर चाहें, तो छात्र या छात्रा को असाइनमेंट सबमिट करने के लिए कंट्रोल दें.
7. अगर आपको छात्र-छात्रा के सबमिट किए गए असाइनमेंट में अटैचमेंट जोड़ने हैं, तो courses.courseWork.studentSubmissions.modifyAttachments से अनुरोध करें. जैसे, Google Drive की फ़ाइल या link Material, जो आपकी वेबसाइट पर छात्र-छात्रा के काम की ओर इशारा करता है.
8. इसके अलावा, छात्र या छात्रा के असाइनमेंट के लिए ग्रेड सेट करने का अनुरोध करने के लिए, courses.courseWork.studentSubmissions.patch पर क्लिक करें.

पहली इमेज. link MaterialCourseWork इंटिग्रेशन की मदद से बनाए गए असाइनमेंट में बदलाव करते समय, शिक्षक को दिखने वाला व्यू.

इसके अलावा, असाइनमेंट के बजाय कोई सूचना या कोर्स का कॉन्टेंट बनाने के लिए, courses.announcements.create या courses.courseWorkMaterials.create को कॉल किया जा सकता है. Classroom API की कार्रवाइयों के बारे में ज़्यादा जानने के लिए, कोर्सवर्क बनाना और उसे मैनेज करना और ग्रेड सेट करना और उन्हें अपडेट करना पेज देखें.

ज़रूरी बातें

CourseWork इंटिग्रेशन को अपने प्रॉडक्ट की ज़रूरतों के हिसाब से सही विकल्प मानने से पहले, इन बातों का ध्यान रखें.

• आपको उपयोगकर्ता को अनुमति देनी होगी और उसकी सहमति के लिए प्रॉम्प्ट करना होगा. आपने उपयोगकर्ता की ओर से एपीआई अनुरोध किए हैं. इसका मतलब है कि उदाहरण के लिए, किसी भी Google Classroom कोर्स में कोर्सवर्क नहीं बनाया जा सकता. कोर्सवर्क सिर्फ़ उन कोर्स में बनाया जा सकता है जिन्हें अनुमति पा चुके उपयोगकर्ता पढ़ाते हैं.
• आपके पास ऐसा तरीका होना चाहिए जिससे उपयोगकर्ता, कॉन्टेंट पाने के लिए कोई कोर्स चुन सके. उपयोगकर्ता के पढ़ाए गए कोर्स की सूची पाने के लिए, courses.list का इस्तेमाल करें. इसके बाद, उपयोगकर्ता को सूची में से एक या उससे ज़्यादा कोर्स चुनने की अनुमति दें.
• जब कोई उपयोगकर्ता Classroom में मौजूद link Material पर क्लिक करता है, तो लिंक एक नए टैब में खुलता है. यूआरएल खुलने पर, आपके सर्वर को Classroom से कोई जानकारी नहीं मिलेगी.
• कोई शिक्षक, डेवलपर से अलग तौर पर कोर्स के काम में बदलाव कर सकता है या उसे मिटा सकता है. इसका मतलब है कि डेवलपर को कोर्स के बारे में मिली जानकारी पुरानी हो सकती है. अगर आपको कोर्स के काम में हुए बदलावों के बारे में सूचना चाहिए, तो कोर्स के काम में हुए बदलावों के लिए पुश नोटिफ़िकेशन सेट अप करें.
• शिक्षक, Classroom के यूज़र इंटरफ़ेस (यूआई) में कोर्सवर्क बना सकते हैं. इसके लिए, वे आपकी वेबसाइट पर मौजूद यूआरएल के लिंक चिपका सकते हैं. इस तरह से बनाए गए कोर्स वर्क का मालिकाना हक सिर्फ़ शिक्षक के पास होता है. इसलिए, Classroom API का इस्तेमाल करके, सबमिट किए गए कोर्स वर्क को न तो देखा जा सकता है, न ही उसमें बदलाव किया जा सकता है. साथ ही, न ही उसके ग्रेड सेट किए जा सकते हैं.