Google Classroom, OneRoster का इस्तेमाल करने वाले कई छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस) के लिए, ग्रेडबुक सिंक करने और रोस्टर इंपोर्ट करने की सुविधा देता है. Google, ऐसे एसआईएस प्लैटफ़ॉर्म के साथ साझेदारी करता है जो Google की तय की गई OneRoster की ज़रूरी शर्तों को पूरा करते हैं.
Classroom के साथ साझेदारी करने पर, एडमिन को अपनी Classroom कक्षाओं को आपके एसआईएस से जोड़ने की सुविधा मिलती है.
पहली इमेज. जब छात्र-छात्राओं की जानकारी का रिकॉर्ड रखने वाले सिस्टम (एसआईएस), Classroom के साथ साझेदारी करते हैं, तो एडमिन ड्रॉप-डाउन में एसआईएस चुन सकते हैं.
एसआईएस पार्टनर के तौर पर डेवलपमेंट की प्रोसेस
अगर आपको Classroom के साथ साझेदारी करनी है, तो ज़्यादा जानने के लिए classroom-sis-external@google.com पर संपर्क करें.
Classroom की टीम ने अनुपालन से जुड़े टेस्ट का एक सेट बनाया है. इसमें दिलचस्पी रखने वाले एसआईएस पार्टनर, Google की ज़रूरी शर्तों के बारे में जान सकते हैं. आपके पास Classroom की टीम से संपर्क करने से पहले, ज़रूरी शर्तों के मुताबिक काम करने की जांच करने का विकल्प है. इससे यह पता चलेगा कि आपका प्रॉडक्ट, Google की ज़रूरी शर्तों के कितने करीब है.
टेस्ट ऐक्सेस करना और उन्हें चलाना
जांच करने के लिए, आपके पास ये चीज़ें होनी चाहिए:
- 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 पर ईमेल करें.