Google Classroom में, OneRoster के साथ काम करने वाले कई एसआईएस (छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम) से छात्र-छात्राओं की सूची इंपोर्ट की जा सकती है और ग्रेडबुक सिंक की जा सकती है. Google, एसआईएस के उन प्लैटफ़ॉर्म के साथ पार्टनरशिप करता है जो OneRoster के लिए Google की तय की गई शर्तों को पूरा करते हैं.
पहली इमेज. जब छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाला सिस्टम (SIS) Classroom के साथ पार्टनरशिप करता है, तो एडमिन ड्रॉप-डाउन मेन्यू में जाकर SIS को चुन सकते हैं.
एसआईएस पार्टनर को शामिल करने की प्रोसेस
यहां एसआईएस पार्टनर के तौर पर शामिल होने की प्रोसेस के बारे में खास जानकारी दी गई है:
दिलचस्पी दिखाना: अगर आपको Classroom के साथ पार्टनरशिप करनी है, तो दिलचस्पी दिखाने वाला फ़ॉर्म भरें.
ज़रूरी शर्तों को पूरा करने से जुड़े टेस्ट के बारे में जानें और उन्हें चलाएं: आपका एसआईएस, Classroom के साथ इंटिग्रेट होने के लिए तैयार है या नहीं, यह जानने के लिए ज़रूरी शर्तों को पूरा करने से जुड़े टेस्ट देखें. इससे आपको Google की ज़रूरी शर्तों के बारे में जानकारी मिलेगी. Google Classroom की टीम को अपनी दिलचस्पी बताने से पहले, आपके पास नियमों के पालन की जांच करने का विकल्प होता है. इससे यह पता चलता है कि आपका प्रॉडक्ट, Google की ज़रूरी शर्तों को कितने करीब से पूरा करता है.
Google Classroom की टीम से संपर्क करें: अगर साझेदारी का कोई अवसर होगा, तो दिलचस्पी दिखाने वाला फ़ॉर्म सबमिट करने के बाद, Classroom की टीम आपसे संपर्क करेगी.
टेस्ट के नतीजे शेयर करना और Classroom के साथ इंटिग्रेशन की प्रोसेस पूरी करना: Classroom की टीम के संपर्क करने पर, टेस्ट के नतीजे शेयर करें. आपकी टीम, इंटिग्रेशन की पुष्टि करने और उसे पूरा करने के लिए, Google के साथ मिलकर काम करेगी.
कॉन्फ़ॉर्मेंस टेस्ट
Google ने कॉन्फ़ॉर्मेंस टेस्ट तय किए हैं. इनसे एसआईएस पार्टनर को यह पता चलता है कि उनका प्रॉडक्ट, Google की OneRoster से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. साथ ही, Classroom में एसआईएस इंटिग्रेशन का इस्तेमाल करते समय, उपयोगकर्ताओं को होने वाली गड़बड़ियों को कम करने में मदद मिलती है. ये टेस्ट, GitHub पर पब्लिश किए जाते हैं.
टेस्ट ऐक्सेस करना और उन्हें चलाना
टेस्ट चलाने के लिए, आपको इनकी ज़रूरत होगी:
- OAuth 2.0 क्रेडेंशियल पाने के लिए टोकन यूआरएल
- OneRoster का यूआरएल, जो
/ims/oneroster/v1p2पर खत्म होता है - क्लाइंट आईडी
- क्लाइंट सीक्रेट
- शिक्षक का ईमेल पता
Google Colab या Jupyter notebook का इस्तेमाल करके, टेस्ट चलाए जा सकते हैं. Colab और Jupyter notebook, दोनों में सभी टेस्ट एक साथ चलाए जा सकते हैं. इससे आपको टेस्ट के नतीजे जनरेट करने में मदद मिलती है, ताकि उन्हें Google Classroom की टीम के साथ शेयर किया जा सके.
ज़रूरी शर्तें और सामान्य रूप से क्या होना चाहिए
टेस्ट के बारे में यहां दिए गए पॉइंट पढ़ें. GitHub में, हर टेस्ट का एक टाइटल होता है. इसे टेबल में रेफ़रंस के तौर पर इस्तेमाल किया जाता है. इन पॉइंटर से सवालों को समझने में मदद मिल सकती है. हालांकि, यह टेस्ट की पूरी सूची नहीं है. पक्का करें कि आपने GitHub पर उपलब्ध सभी टेस्ट चलाए हों, ताकि यह पक्का किया जा सके कि आपका ऐप्लिकेशन सभी ज़रूरी शर्तों को पूरा करता है.
| टेस्ट | पॉइंटर |
|---|---|
| Teachers: GetAllTeachers | GET /teachers एंडपॉइंट को limit क्वेरी पैरामीटर के साथ कॉल किया जाता है. इसके बाद होने वाले टेस्ट में, इस पैरामीटर का इस्तेमाल करके यह पक्का किया जाता है कि आपका प्रॉडक्ट, 10,000 पेज साइज़ के साथ काम कर सकता है. |
| शिक्षक: ईमेल फ़िल्टर के साथ GetAllTeachers | GET /teachers एंडपॉइंट को filter क्वेरी पैरामीटर के साथ कॉल किया जाता है. इसका इस्तेमाल, शिक्षक के ईमेल पते के आधार पर फ़िल्टर करने के लिए किया जाता है. इसके लिए, शिक्षक के उस ईमेल पते का इस्तेमाल किया जाएगा जो आपने टेस्ट के क्रेडेंशियल सेक्शन में दिया था. |
| क्लास: GetClassesForTeacher | /teachers/{teacher_sourced_id}/classes एंडपॉइंट को filter क्वेरी पैरामीटर के साथ कॉल किया जाता है. इसका इस्तेमाल, चालू क्लास के आधार पर फ़िल्टर करने के लिए किया जाता है. |
| छात्र-छात्राएं: GetStudentsForClass | GET /classes/{class_sourced_id}/students एंडपॉइंट को कॉल किया जाता है. जवाब में छात्र/छात्रा का ईमेल पता शामिल होना चाहिए. |
| GetGradingPeriodsForTerm | ग्रेडिंग पीरियड की सुविधा की जांच, term_sourced_id का इस्तेमाल करके की जाती है. इस term_sourced_id का इस्तेमाल, GET /terms/{term_sourced_id}/gradingPeriods एंडपॉइंट को कॉल करके, टर्म के ग्रेडिंग पीरियड को वापस पाने के लिए किया जाता है. |
| LineItem: Create | PUT /lineItems/{line_item_sourced_id} को कॉल करते समय, ग्रेडिंग पीरियड की ज़रूरत नहीं होती. |
| LineItem: बदलाव करें | अगर असाइनमेंट का टाइटल लंबा है, तो एपीआई कॉल में गड़बड़ी नहीं होनी चाहिए. इस टेस्ट में, असाइनमेंट के टाइटल की लंबाई 100 से ज़्यादा वर्णों की है. |
| नतीजा: बदलाव करें | अतिरिक्त क्रेडिट दिखाने के लिए, score को resultValueMax से ज़्यादा वैल्यू पर सेट किया जा सकता है. |
| नतीजा: मिटाएं | DELETE /results/{result_sourced_id} एंडपॉइंट ज़रूरी है. |
| LineItem (ज़रूरी नहीं / क्लीनअप): मिटाना और पाना | DELETE /lineItems/{line_item_sourced_id} एंडपॉइंट की ज़रूरत नहीं है. यह ज़रूरी नहीं है और इसका इस्तेमाल डेटा हटाने की सुविधा के लिए किया जाता है. इसके बाद का GET /classes/{class_sourced_id}/lineItems एंडपॉइंट भी ज़रूरी नहीं है. यह टेस्ट करता है कि लाइन आइटम मिटाया गया है या नहीं. |
जांच के नतीजे, Google Classroom की टीम के साथ शेयर करें
टेस्ट चलाने के बाद, हर टेस्ट के नतीजों के साथ एक पूरी रिपोर्ट जनरेट होती है. नतीजों का इस्तेमाल यह तय करने के लिए किया जाता है कि आपका प्रॉडक्ट, Google की OneRoster 1.2 के इस्तेमाल से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. जनरेट की गई रिपोर्ट को डाउनलोड करें या उसका स्क्रीनशॉट लें. इसके बाद, उसे Google Classroom की टीम में शामिल अपने संपर्कों के साथ शेयर करें.
डेवलपर के लिए डेमो डोमेन पाना
Google Classroom की टीम, आपके इंटिग्रेशन की जांच के नतीजों की समीक्षा करती है. इसके बाद, डेवलपर डेमो डोमेन की मदद से, आपको अपने इंटिग्रेशन की पूरी तरह से पुष्टि करने की सुविधा मिलती है. ध्यान रखें कि ज़रूरी शर्तों को पूरा करने वाले टेस्ट पास करने से, साझेदारी या इंटिग्रेशन की मंज़ूरी मिलने की गारंटी नहीं मिलती.
डेवलपर डेमो डोमेन, Google Classroom का एक लाइव और टेस्ट एनवायरमेंट है. इसकी मदद से, यह पुष्टि की जा सकती है कि आपका इंटिग्रेशन आपकी उम्मीद के मुताबिक काम कर रहा है या नहीं. डेवलपर डेमो डोमेन पाने और डेमो डोमेन को अपग्रेड करने का अनुरोध करने के लिए, यह तरीका अपनाएं. अपग्रेड करने पर, आपके डोमेन को Google Workspace for Education Plus के 10 लाइसेंस मिलते हैं. ये लाइसेंस, आपके डेवलपर डोमेन में मौजूद टेस्ट उपयोगकर्ताओं को असाइन करने होंगे, ताकि वे Classroom में एसआईएस इंटिग्रेशन की सुविधाओं को टेस्ट कर सकें.
अक्सर पूछे जाने वाले सवाल
1. Classroom को एसआईएस से किस तरह का डेटा मॉडल चाहिए?
Classroom, OneRoster 1.2 के स्पेसिफ़िकेशन का पालन करता है. अगर आपका एसआईएस किसी दूसरे डेटा स्ट्रक्चर का इस्तेमाल करता है, तो आपको अनचाहे व्यवहार का सामना करना पड़ सकता है. उदाहरण के लिए, अगर आपका सिस्टम ग्रेडिंग पीरियड और ग्रेड की कैटगरी के बीच नेस्ट किए गए संबंध के साथ काम करता है, तो यह OneRoster 1.2 की खास जानकारी से बाहर है. साथ ही, आपको अपने इंटिग्रेशन की अच्छी तरह से जांच करनी चाहिए, ताकि यह पक्का किया जा सके कि वह सही तरीके से काम करता है.
2. एसआईएस पर कौनसे ग्रेड और असाइनमेंट के स्टेटस एक्सपोर्ट किए जाते हैं?
एसआईएस में सिर्फ़ लौटाए गए ग्रेड या "सबमिट नहीं किया गया" या "छूट दी गई है" के तौर पर मार्क किए गए असाइनमेंट एक्सपोर्ट किए जाते हैं. अधूरे ग्रेड एक्सपोर्ट नहीं किए जाते.
3. अगर Classroom में कोई असाइनमेंट मिटा दिया जाता है, तो एसआईएस में मौजूद लाइन आइटम का क्या होता है?
Classroom में किसी असाइनमेंट को मिटाने पर, एसआईएस में मौजूद उससे जुड़ा लाइन आइटम नहीं मिटता. इससे डेटा को गलती से मिटने से बचाया जा सकता है. साथ ही, अनचाहे कैस्केड डिलीशन को रोका जा सकता है.