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

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

आम तौर पर, इस इंटिग्रेशन पाथ का इस्तेमाल, 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 से अनुरोध करें.

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

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

ज़रूरी बातें

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

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