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