छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम के लिए OneRoster

Google Classroom, OneRoster का इस्तेमाल करने वाले कई छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस) के लिए, ग्रेडबुक सिंक करने और रोस्टर इंपोर्ट करने की सुविधा देता है. Google, एसआईएस प्लैटफ़ॉर्म के साथ पार्टनरशिप करता है. हालांकि, इसके लिए ज़रूरी है कि वे OneRoster से जुड़ी Google की ज़रूरी शर्तें पूरी करते हों.

Classroom के साथ साझेदारी करने पर, एडमिन को अपनी Classroom कक्षाओं को आपके एसआईएस से जोड़ने की सुविधा मिलती है.

पहली इमेज. जब छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस), Classroom के साथ साझेदारी करते हैं, तो एडमिन ड्रॉप-डाउन में एसआईएस चुन सकते हैं.

एसआईएस पार्टनर के तौर पर डेवलपमेंट की प्रोसेस

अगर आपको Classroom के साथ साझेदारी करनी है, तो ज़्यादा जानने के लिए classroom-sis-external@google.com पर संपर्क करें.

Classroom की टीम ने अनुपालन से जुड़े टेस्ट का एक सेट बनाया है. इसमें दिलचस्पी रखने वाले एसआईएस पार्टनर, 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 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 एंडपॉइंट को कॉल करके, टर्म में ग्रेडिंग पीरियड को वापस पाने के लिए किया जाता है.
लाइन आइटम: बनाना PUT /lineItems/{line_item_sourced_id} को कॉल करते समय, ग्रेडिंग पीरियड की ज़रूरत नहीं होती.
लाइन आइटम: बदलाव करना अगर असाइनमेंट के टाइटल में बहुत लंबी स्ट्रिंग शामिल की गई है, तो एपीआई कॉल से कोई गड़बड़ी नहीं दिखनी चाहिए. टेस्ट में असाइनमेंट का टाइटल 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 पर ईमेल करें.