पुष्टि करें कि आपका SIS, Google Classroom की ज़रूरी शर्तों को पूरा करता है

अपने SIS को Classroom से इंटिग्रेट करने के लिए, इस बात की पुष्टि करें कि आपका प्रॉडक्ट, Classroom की पार्टनरशिप की ज़रूरी शर्तों को पूरा करता है. इसके लिए, कंफ़ॉर्मैंस टेस्ट के सेट का इस्तेमाल करें.

टेस्ट ऐक्सेस करना और चलाना

आपके पास GitHub पर कंफ़ॉर्मैंस टेस्ट का ऐक्सेस पाने का विकल्प है. जांच करने के लिए, आपको इन चीज़ों की ज़रूरत होगी:

  • OAuth 2.0 क्रेडेंशियल को फिर से पाने के लिए टोकन यूआरएल
  • /ims/oneroster/v1p1 से खत्म होने वाला एक रोस्टर यूआरएल
  • Client ID
  • क्लाइंट सीक्रेट
  • शिक्षक का ईमेल पता

टेस्ट सुइट में तीन सेक्शन हैं:

  • बेसिक ग्रेड सिंक
  • ग्रेड कैटगरी
  • ग्रेडिंग की अवधि

Google Colab या Jupyter notebook का इस्तेमाल करके, ये जांच की जा सकती हैं. Colab और Jupyter notebook, दोनों आपको एक साथ सभी टेस्ट करने देते हैं. इससे आपको टेस्ट के नतीजे जनरेट करने में मदद मिलती है, ताकि इन्हें Google Classroom की टीम के साथ शेयर किया जा सके.

SIS से जुड़ी ज़रूरी शर्तें और उनका व्यवहार

Google के तय किए गए टेस्ट, एक जैसे बनाए रखने के लिए किए जाते हैं. साथ ही, Classroom के साथ SIS इंटिग्रेशन का इस्तेमाल करते समय, उपयोगकर्ताओं को होने वाली गड़बड़ियों को कम करते हैं. जांच के बारे में नीचे दिए गए पॉइंटर पढ़ें. GitHub में हर टेस्ट को @title के तौर पर मार्क किया गया है. इन टाइटल के बारे में पॉइंटर में बताया गया है.

  1. बेसिक ग्रेड सिंक सेक्शन के बारे में इन बातों का ध्यान रखें:

    • 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?limit=10000 एंडपॉइंट को कॉल किया जाता है. जवाब के तौर पर छात्र/छात्रा का ईमेल पता वापस आना चाहिए.

    • PutLineItem Create टेस्ट में, PUT /lineItems/{line_item_sourced_id} पर कॉल करते समय, ग्रेड कैटगरी या ग्रेडिंग पीरियड की ज़रूरत नहीं होती.

    • PutLineItem Edit टेस्ट में, असाइनमेंट के लंबे टाइटल को शामिल करने पर, एपीआई कॉल से गड़बड़ी का मैसेज नहीं मिलना चाहिए. इस टेस्ट में असाइनमेंट के शीर्षक के लिए 100 से ज़्यादा वर्ण शामिल हैं.

    • PutResult Edit टेस्ट में, अतिरिक्त क्रेडिट दिखाने के लिए, score की वैल्यू को resultValueMax से ज़्यादा पर सेट करना चाहिए.

    • DELETE /results/{result_sourced_id} एंडपॉइंट ज़रूरी है और इसे DeleteResult टेस्ट में टेस्ट किया गया है.

    • DELETE /lineItems/{line_item_sourced_id} एंडपॉइंट की ज़रूरत नहीं है. यह ज़रूरी नहीं है. इसका इस्तेमाल डेटा हटाने के लिए किया जाता है.

  2. ग्रेड कैटगरी और ग्रेडिंग पीरियड सेक्शन के बारे में नीचे दी गई बातों का ध्यान रखें:

    • सिर्फ़ एक GET /categories एंडपॉइंट की ज़रूरत है. अगर सभी कन्फ़ॉर्मैंस टेस्ट एक साथ कर रहे हैं, तो उस टाइप के बारे में बताएं जिसका इस्तेमाल नहीं किया जा रहा है:
      • /categories?limit=10000
      • /classes/{class_sourced_id}/categories?limit=10000
    • ग्रेडिंग पीरियड से जुड़ी सहायता की जांच करने के लिए, GetAllClasses w/ filter टेस्ट में term_sourced_id को वापस पाया जाता है. इस term_sourced_id का इस्तेमाल, टर्म में ग्रेडिंग पीरियड की जानकारी पाने के लिए किया जाता है. इसके लिए, GetGradingPeriodsForTerm टेस्ट में GET terms/{term_sourced_id}/gradingPeriods?limit=10000 एंडपॉइंट पर कॉल किया जाता है.

Google Classroom की टीम के साथ टेस्ट के नतीजे शेयर करें

जांच करने के बाद, हर जांच के नतीजों की पूरी रिपोर्ट जनरेट की जाती है. इन टेस्ट से यह पता लगाया जाता है कि आपका प्रॉडक्ट, OneRoster 1.1 इस्तेमाल करने की Google की ज़रूरी शर्तों को पूरा करता है या नहीं. जनरेट की गई रिपोर्ट को डाउनलोड करें या उसका स्क्रीनशॉट लें. रिपोर्ट और अपने प्रॉडक्ट के OneRoster 1.1 सर्टिफ़िकेशन के लिंक को classroom-sis-external@google.com पर ईमेल करें.

सहायता पाएँ

अगर आपका कोई सवाल है या कोई समस्या है, तो classroom-sis-external@google.com पर ईमेल करें.