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

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

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

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

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

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

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

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

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

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

ज़रूरी बातें

अहम जानकारी: CourseWork इंटिग्रेशन की कुछ अहम सीमाएं हैं. अगर इन वजहों से आपको अपना प्रॉडक्ट बनाने में समस्या आ रही है, तो इसके बजाय Google Classroom ऐड-ऑन बनाएं.

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

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