अपने एसआईएस को Classroom के साथ इंटिग्रेट करने के लिए, संगतता की जांच के लिए दिए गए सेट को चलाकर पुष्टि करें कि आपका प्रॉडक्ट, Classroom की पार्टनरशिप की ज़रूरी शर्तों को पूरा करता है.
टेस्ट ऐक्सेस करना और उन्हें चलाना
GitHub पर, नीति का पालन करने से जुड़े टेस्ट ऐक्सेस किए जा सकते हैं. जांच करने के लिए, आपके पास ये चीज़ें होनी चाहिए:
- OAuth 2.0 क्रेडेंशियल पाने के लिए टोकन यूआरएल
/ims/oneroster/v1p1पर खत्म होने वाला रोस्टर यूआरएल- Client-ID
- क्लाइंट सीक्रेट
- शिक्षक का ईमेल पता
टेस्ट सुइट में तीन सेक्शन होते हैं:
- ग्रेड सिंक करने की बुनियादी सुविधा
- ग्रेडिंग कैटगरी
- ग्रेडिंग पीरियड
Google Colab या Jupyter notebook का इस्तेमाल करके, टेस्ट चलाए जा सकते हैं. Colab और Jupyter notebook, दोनों में एक साथ सभी टेस्ट चलाए जा सकते हैं. इससे आपको टेस्ट के नतीजे जनरेट करने में मदद मिलती है, ताकि आप उन्हें Google Classroom की टीम के साथ शेयर कर सकें.
एसआईएस से जुड़ी ज़रूरी शर्तें और उसका काम करने का तरीका
Google की ओर से तय किए गए टेस्ट, एक जैसी परफ़ॉर्मेंस बनाए रखने और 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 एंडपॉइंट को कॉल किया जाता है. जवाब में छात्र/छात्राओं का ईमेल पता वापस भेजना ज़रूरी है. |
| लाइन आइटम: बनाना | 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 एंडपॉइंट भी ज़रूरी नहीं है. इससे यह जांच की जाती है कि लाइन आइटम मिटाया गया है या नहीं. |
ग्रेडिंग कैटगरी
| टेस्ट | पॉइंटर |
|---|---|
| GetAllCategories या GetCategoriesForClass | सिर्फ़ एक GET /categories एंडपॉइंट ज़रूरी है, या तो GetAllCategories या GetCategoriesForClass. अगर सभी टेस्ट एक साथ चलाए जा रहे हैं, तो उस टेस्ट को कॉमेंट आउट करें जिसका इस्तेमाल नहीं किया जा रहा है. |
| DeleteLineItem (ज़रूरी नहीं / क्लीनअप) | DeleteLineItem टेस्ट करना ज़रूरी नहीं है. इसका इस्तेमाल डेटा को साफ़ करने के लिए किया जा सकता है. |
ग्रेडिंग पीरियड
| टेस्ट | पॉइंटर |
|---|---|
| GetGradingPeriodsForTerm | ग्रेडिंग की अवधियों के साथ काम करने की सुविधा की जांच करने के लिए, फ़िल्टर टेस्ट के साथ GetAllClasses में term_sourced_id को वापस लाया जाता है. इस term_sourced_id का इस्तेमाल, GetGradingPeriodsForTerm टेस्ट में GET terms/{term_sourced_id}/gradingPeriods एंडपॉइंट को कॉल करके, टर्म में ग्रेडिंग की अवधियों को वापस पाने के लिए किया जाता है. |
जांच के नतीजे, Google Classroom की टीम के साथ शेयर करना
टेस्ट चलाने के बाद, हर टेस्ट के नतीजों के साथ एक पूरी रिपोर्ट जनरेट होती है. इन टेस्ट का इस्तेमाल यह पता लगाने के लिए किया जाता है कि आपका प्रॉडक्ट, Google के OneRoster 1.1 के इस्तेमाल से जुड़ी ज़रूरी शर्तों को पूरा करता है या नहीं. जनरेट की गई रिपोर्ट को डाउनलोड करें या उसका स्क्रीनशॉट लें. classroom-sis-external@google.com पर ईमेल भेजकर, रिपोर्ट और अपने प्रॉडक्ट के OneRoster 1.1 सर्टिफ़िकेशन का लिंक भेजें.
सहायता पाएं
अगर आपका कोई सवाल या समस्या है, तो classroom-sis-external@google.com पर ईमेल करें.