Google Classroom, OneRoster के साथ काम करने वाले कई छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस) के लिए, ग्रेडबुक सिंक करने और नामावली इंपोर्ट करने की सुविधा देता है. Google, एसआईएस की सेवा देने वाले उन प्लैटफ़ॉर्म के साथ पार्टनरशिप करता है जो Google की तय की गई OneRoster की ज़रूरी शर्तों को पूरा करते हैं.
Classroom के साथ पार्टनरशिप करने से, एडमिन को अपनी Classroom क्लास को आपके एसआईएस से कनेक्ट करने की सुविधा मिलती है.
पहली इमेज. जब छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस), Classroom के साथ पार्टनरशिप करते हैं, तब एडमिन ड्रॉप-डाउन में एसआईएस चुन सकते हैं.
SIS पार्टनर डेवलपमेंट जर्नी
अगर आपको Classroom के साथ पार्टनरशिप करनी है, तो दिलचस्पी दिखाने वाला फ़ॉर्म भरें.
Classroom की टीम ने अनुपालन से जुड़े टेस्ट का एक सेट बनाया है. इसमें दिलचस्पी रखने वाले SIS पार्टनर, Google की ज़रूरी शर्तों के बारे में जानने के लिए इनका इस्तेमाल कर सकते हैं. आपके पास, Classroom की टीम से संपर्क करने से पहले, कंफ़ॉर्मंस टेस्ट करने का विकल्प होता है. इससे यह पता चलता है कि आपका प्रॉडक्ट, Google की ज़रूरी शर्तों को किस हद तक पूरा करता है.
डेवलपर डेमो डोमेन पाना
आपको इंटिग्रेशन बनाने और उसकी पुष्टि करने के लिए, Google Classroom के लाइव इंस्टेंस का ऐक्सेस चाहिए. टेस्ट करने वाले उपयोगकर्ताओं के पास, Google Workspace for Education का Plus वर्शन होना चाहिए. अगर आपके पास इन लाइसेंस के साथ Google Workspace for Education डोमेन का एडमिन ऐक्सेस नहीं है, तो डेवलपर टेस्ट डोमेन पाने और डेमो डोमेन को अपग्रेड करने का अनुरोध करने के लिए, यह तरीका अपनाएं. आपके डोमेन को Google Workspace for Education Plus के 10 लाइसेंस उपलब्ध कराए जाएंगे.
टेस्ट ऐक्सेस करना और उन्हें चलाना
जांच करने के लिए, आपको इनकी ज़रूरत होगी:
- OAuth 2.0 क्रेडेंशियल पाने के लिए टोकन यूआरएल
- OneRoster का यूआरएल
/ims/oneroster/v1p1पर खत्म होता है - Client-ID
- क्लाइंट सीक्रेट
- शिक्षक का ईमेल पता
Google Colab या Jupyter notebook का इस्तेमाल करके, टेस्ट चलाए जा सकते हैं. Colab और Jupyter notebook, दोनों में एक साथ सभी टेस्ट चलाए जा सकते हैं. इससे आपको टेस्ट के नतीजे जनरेट करने में मदद मिलती है, ताकि उन्हें Google Classroom की टीम के साथ शेयर किया जा सके.
एसआईएस से जुड़ी ज़रूरी शर्तें और उम्मीद के मुताबिक काम करने का तरीका
Google ने ये टेस्ट इसलिए बनाए हैं, ताकि एसआईएस पार्टनर यह पता लगा सकें कि उनका प्रॉडक्ट, Google के OneRoster के इस्तेमाल से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. साथ ही, इससे उन गड़बड़ियों को कम किया जा सकता है जो उपयोगकर्ताओं को Classroom में एसआईएस इंटिग्रेशन का इस्तेमाल करते समय आ सकती हैं. टेस्ट के बारे में यहां दी गई जानकारी पढ़ें. GitHub में, हर टेस्ट का एक टाइटल होता है. इसका रेफ़रंस पॉइंटर में दिया जाता है. ध्यान रखें कि इन पॉइंटर से सवालों को समझने में मदद मिल सकती है. हालांकि, यह टेस्ट की पूरी सूची नहीं है. पक्का करें कि आपने GitHub पर दिए गए सभी टेस्ट किए हों.
अनुपालन की जांच के नतीजों का इस्तेमाल करें.| टेस्ट | पॉइंटर |
|---|---|
| शिक्षकों के लिए: GetAllTeachers | GET /teachers एंडपॉइंट को limit क्वेरी पैरामीटर के साथ कॉल किया जाता है. इसके बाद होने वाली जांचों में, इस पैरामीटर का इस्तेमाल यह पक्का करने के लिए किया जाता है कि आपका प्रॉडक्ट, 10,000 पेज साइज़ के साथ काम कर सकता है. |
| शिक्षकों के लिए: GetAllTeachers with email filter | 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: Edit | अगर असाइनमेंट के टाइटल की लंबाई ज़्यादा है, तो एपीआई कॉल को गड़बड़ी नहीं दिखानी चाहिए. इस टेस्ट में, असाइनमेंट के टाइटल की लंबाई 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 की टीम के साथ शेयर किया जा सके.
सहायता पाएं
अगर आपका कोई सवाल है, तो classroom-sis-external@google.com पर ईमेल भेजें.