ऐड-ऑन की ज़रूरी शर्तें

वर्शन 1.0, 30 अप्रैल, 2024.

इस पेज पर दी गई शर्तें, Classroom के सभी ऐड-ऑन पर लागू होती हैं. Google Workspace Marketplace में लिस्टिंग के लिए मंज़ूरी पाने के लिए, आपके ऐड-ऑन को सभी ज़रूरी शर्तों को पूरा करना ज़रूरी है. साथ ही, यह भी ज़रूरी है कि आपका ऐड-ऑन "Classroom के साथ काम करता हो".

इस दस्तावेज़ में मौजूद कीवर्ड "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", और "OPTIONAL" का मतलब, RFC 2119 में बताए गए तरीके से समझा जाना चाहिए.

ज़रूरी शर्तें

आईडी टाइप
1.0 असली उपयोगकर्ता के लिए लाइसेंस (अगर लागू हो)
  1.1 जब उपयोगकर्ता के पास लाइसेंस न हो, तब उसे आसानी से समझ आने वाला मैसेज दिखाना ज़रूरी है. मैसेज में यह साफ़ तौर पर बताया जाना चाहिए कि ऐड-ऑन का इस्तेमाल क्यों नहीं किया जा सकता. साथ ही, समस्या को ठीक करने के लिए उपयोगकर्ता को कोई सुझाव भी दिया जाना चाहिए. ज़रूरी है
  1.3 ऐड-ऑन की Google Workspace Marketplace लिस्टिंग में, लाइसेंस से जुड़ी उन ज़रूरी शर्तों के बारे में जानकारी होनी चाहिए जो ऐड-ऑन का इस्तेमाल करने के लिए ज़रूरी हो सकती हैं. अगर ऐड-ऑन के लिए पैसे चुकाने होते हैं, तो मार्केटप्लेस की लिस्टिंग में उस वेबपेज का लिंक होना चाहिए जिस पर कीमत या सेल्स पर्सन से संपर्क करने के तरीके के बारे में ज़्यादा जानकारी दी गई हो. ज़रूरी है
2.0 असली उपयोगकर्ता के लिए साइन इन करना
  2.1 शिक्षक उपयोगकर्ताओं को Google एसएसओ का इस्तेमाल करके, ऐड-ऑन में साइन इन करना होगा.
अगर छात्र-छात्राओं से ऐड-ऑन में साइन-इन करने के लिए कहा जाता है, तो उन्हें Google एसएसओ का इस्तेमाल करके साइन इन करना होगा.
ज़रूरी है
  2.2 ऐड-ऑन को Google एसएसओ (SSO) का इस्तेमाल करना होगा, ताकि लॉगिन संकेत दिखाए बिना, उपयोगकर्ता को अगली बार वेबसाइट पर आने के बाद अपने-आप साइन इन कराया जा सके.
जब लॉगिन संकेत से, साइन-इन किए हुए मौजूदा उपयोगकर्ता से मैच न मिले, तो ऐड-ऑन को साइन-इन बटन का इस्तेमाल करके उपयोगकर्ता को साइन-इन करने का संकेत देना होगा. साथ ही, अमान्य खातों को फ़िल्टर करने के लिए, को सही लाइब्रेरी में लॉगिन करना होगा.
ज़रूरी है
  2.7 अगर Classroom का उपयोगकर्ता, पहले से ही ऐड-ऑन में साइन इन नहीं किया हुआ है (जैसा कि लॉगिन के लिए दिए गए हिंट से पता चलता है), तो साइन-इन की प्रोसेस को ट्रिगर करने के लिए, उपयोगकर्ता की साफ़ तौर पर की गई कार्रवाई के लिए, ऐड-ऑन में 'Google से साइन इन करें' बटन होना ज़रूरी है.
ध्यान दें: Google के ब्रैंडिंग दिशा-निर्देशों का पालन करने के लिए, यह ज़रूरी है. साथ ही, इससे पॉप-अप ब्लॉक करने वाले टूल से भी बचा जा सकता है.
ज़रूरी है
  2.8 ऐड-ऑन में यह दिखना चाहिए कि फ़िलहाल साइन इन किया हुआ उपयोगकर्ता कौन है. सुझाया गया
3.0 सामान्य
  3.1 ऐड-ऑन को Google Workspace Marketplace के लिए मंज़ूरी से जुड़े सामान्य दिशा-निर्देशों का पालन करना होगा. ज़रूरी है
  3.2 अगर किसी टास्क को किसी भी iframe जर्नी से नए टैब या विंडो में लॉन्च किया जाता है, तो उसे Classroom पर वापस जाने के लिए, उपयोगकर्ता के हिसाब से मैसेज देना होगा. ज़रूरी है
  3.3 उपयोगकर्ता को सिर्फ़ ऐड-ऑन वर्कफ़्लो का इस्तेमाल करके, प्रक्रिया को पूरा करना होगा. उन्हें कोर्सवर्क फ़्लो पर स्विच करने या 'क्लासरूम शेयर करें' बटन का इस्तेमाल करने की ज़रूरत नहीं है. ज़रूरी है
  3.4 स्थानीय भाषा चुनने का विकल्प: भाषा, ब्राउज़र की सेट की गई स्थानीय प्राथमिकता पर आधारित होनी चाहिए. सुझाया गया
  3.5 अगर कोई ऐड-ऑन maxPoints तय करता है, तो उसे pointsEarned भी सेट करना होगा. ऐसा तब करना होगा, जब छात्र-छात्राएं शिक्षक के सेव किए गए क्रेडेंशियल का इस्तेमाल करके कोई सबमिशन पूरा करें (सुझाया गया) या जब शिक्षक, छात्र-छात्राओं के काम की समीक्षा करने वाले iframe में सबमिशन खोले. ज़रूरी है
  3.9 ऐड-ऑन, सुलभता से जुड़े दिशा-निर्देशों के मुताबिक होने चाहिए. जैसे, WCAG 2.1 लेवल AA. ऐड-ऑन डेवलपर, सबमिशन के समय खुद ही यह रिपोर्ट करेंगे कि यह ज़रूरी शर्त पूरी की गई है. साथ ही, यह भी बताएंगे कि आने वाले समय में ऐड-ऑन में किए जाने वाले बदलावों के मुताबिक, ऐड-ऑन का पालन किया जा रहा है. सुझाया गया
  3.10 उपयोगकर्ता को मिलने वाली गड़बड़ियों को पढ़ा जा सकता हो. ज़रूरी है
  3.11 अगर studentViewUri, teacherViewUri या studentWorkViewUri को कॉपी किए गए असाइनमेंट या कॉपी किए गए कोर्स से लॉन्च किया जाता है, तो ऐड-ऑन को iframe में गड़बड़ी का पेज नहीं दिखाना चाहिए. ज़रूरी है
  3.12 अगर studentViewUri, teacherViewUri या studentWorkViewUri को कॉपी किए गए असाइनमेंट या कॉपी किए गए कोर्स से लॉन्च किया जाता है, तो ऐड-ऑन को छात्र के लिए एक नया अटैचमेंट दिखाना चाहिए. साथ ही, iframe में छात्र के पिछले असाइनमेंट या कोर्स के जवाब नहीं दिखाने चाहिए. सुझाया गया
4.0 अटैचमेंट डिस्कवरी
  4.1 अगर किसी अटैचमेंट के लिए छात्र को सबमिशन करना ज़रूरी है, तो उस अटैचमेंट में studentWorkReviewUri होना चाहिए. इससे उसे गतिविधि के टाइप के तौर पर माना जाएगा, न कि कॉन्टेंट के टाइप के तौर पर. ज़रूरी है
  4.2 अटैचमेंट डिस्कवरी iframe में ऐसा यूज़र इंटरफ़ेस होना चाहिए जो इनमें से कम से कम एक सुविधा देता हो:
  • अटैच करने के लिए नया कॉन्टेंट बनाना
  • कॉन्टेंट लाइब्रेरी से ब्राउज़ करना, चुनना, और अटैच करना
  • अपनी वेबसाइट या अन्य प्रॉडक्ट से कॉन्टेंट अटैच करने के लिए निर्देश
ज़रूरी है
  4.3 शिक्षक के पास, अपने लिए उपलब्ध सभी कॉन्टेंट/गतिविधियों को ढूंढने और ऐक्सेस करने की सुविधा होनी चाहिए. सुझाया गया
  4.4 शिक्षक को असाइनमेंट में कॉन्टेंट/गतिविधि को अटैच करने से पहले, उसकी झलक देखनी होगी. ज़रूरी है
  4.5 अगर शिक्षक के लिए, कॉन्टेंट या गतिविधि बनाए जाने की ज़रूरत है, तो उस काम को iframe में पूरा किया जाना चाहिए. सुझाया गया
5.0 छात्र का व्यू
  5.1 studentViewUri लॉन्च होने के बाद, किसी टास्क को पूरा करने के लिए ऐड-ऑन को उपयोगकर्ता को iframe से पॉप-आउट नहीं करना चाहिए.
अगर ऐड-ऑन, उपयोगकर्ता को iframe से बाहर दिखाता है, तो Classroom पर वापस आने के लिए छात्र-छात्राओं को कोई मैसेज या अन्य संकेत देना चाहिए.
सुझाया गया
  5.2 अगर कोई ऐड-ऑन गतिविधि iframe से बाहर पॉप आउट करती है, तो iframe में टास्क की झलक ज़रूर होनी चाहिए. ज़रूरी है
  5.3 अगर किसी गतिविधि को पूरा होने के तौर पर मार्क करने के लिए, छात्र को कोई कार्रवाई करनी है, तो बटन को 'सबमिट करें' के तौर पर लेबल नहीं किया जाना चाहिए. ऐसा इसलिए, ताकि Classroom के सबमिट करें बटन से भ्रम न हो. ज़रूरी है
6.0 शिक्षक का व्यू
  6.1 शिक्षक को यह दिखना चाहिए कि छात्र-छात्राओं को असाइनमेंट करते समय क्या दिखेगा. सुझाया गया
7.0 छात्र/छात्रा के काम की समीक्षा
  7.1 अगर studentWorkReviewUri लॉन्च किया जाता है, तो ऐड-ऑन को उस छात्र/छात्रा के काम को iframe में रेंडर करना होगा, ताकि शिक्षक उसकी समीक्षा कर सके. ज़्यादा जानकारी देने वाला कॉन्टेंट, iframe के बाहर लिंक किया जा सकता है. ज़रूरी है
  7.2 ऐड-ऑन, studentWorkReviewUri व्यू में छात्र-छात्राओं के बीच नेविगेट करने की सुविधा चालू नहीं करेगा. छात्र-छात्राओं के बीच नेविगेट करने के लिए, सिर्फ़ Classroom के यूज़र इंटरफ़ेस (यूआई) का इस्तेमाल किया जाना चाहिए. ज़रूरी है
8.0 Classroom मोबाइल सहायता
  8.1 जब Classroom का मोबाइल ऐप्लिकेशन teacherViewUri, studentViewUri या studentWorkReviewUri लॉन्च करता है, तो यूआरएल को पार्टनर का मोबाइल नेटिव ऐप्लिकेशन या पार्टनर का मोबाइल वेब ऐप्लिकेशन खोलना चाहिए. साथ ही, दोनों ही मामलों में, सही व्यू पर डीप-लिंक करना चाहिए. अगर डिवाइस इस पर काम नहीं करता है, तो उपयोगकर्ता को एक मैसेज दिखाया जाना चाहिए. इससे उन्हें यह बताया जाना चाहिए कि यह डिवाइस इस पर काम नहीं करता. आम तौर पर, यह बताएं कि किन डिवाइसों पर इस डिवाइस का इस्तेमाल किया जा सकता है. ज़रूरी है
  8.2 छात्र-छात्राओं को मोबाइल डिवाइस पर अपना काम पूरा करना चाहिए. सुझाया गया
9.0 अतिरिक्त सुविधाएं
  9.1 अगर शिक्षक आपके कॉन्टेंट के लिंक, लिंक अटैचमेंट के तौर पर चिपका सकते हैं, तो आपको ऐड-ऑन अटैचमेंट में लिंक को अपग्रेड करना होगा. सुझाया गया
  9.2 अगर Classroom के बाहर असाइनमेंट बनाने के लिए, courseWork इंटिग्रेशन का इस्तेमाल किया जाता है, तो अपने ऐड-ऑन के साथ काम करने वाले सभी लिंक के लिए, आपको डिफ़ॉल्ट रूप से ऐड-ऑन अटैचमेंट बनाने चाहिए. सुझाया गया

बदलावों का लॉग

संस्करण 1.0 अपडेट होने की तारीख: 30 अप्रैल, 2024
1.1 1.1 और 1.2 को एक ही ज़रूरी शर्त में जोड़ा गया है.
2.1 2.1 और 2.5 को एक ही शर्त में शामिल कर दिया गया है.
2.2 2.2, 2.3, और 2.4 को एक ही ज़रूरी शर्त में जोड़ा गया है.
3.5 3.5, 3.6, और 3.7 को एक ही ज़रूरी शर्त में जोड़ा गया है.
3.10 यह ज़रूरी शर्त जोड़ी गई है कि ऐड-ऑन कभी भी ऐसी स्थिति में न आए जिसे समझा न जा सके या जिसे ठीक न किया जा सके.
3.11, 3.12 5.5, 5.6, 6.3, 6.4, 7.5, और 7.6 को दो नई ज़रूरी शर्तों में बदला गया है.
4.2 अटैचमेंट डिस्कवरी के लिए स्वीकार किए जाने वाले अनुभवों के बारे में ज़्यादा जानकारी दी गई है.
4.3 नंबर बदला गया, पहले इसे 4.2 कहा जाता था. 'ज़रूरी' से बदलकर सुझाया गया.
4.4 नंबर बदला गया, पहले यह 4.3 था.
4.5 इसे फिर से नंबर दिया गया है. पहले इसे 4.4 कहा जाता था.
5.2 नंबर बदला गया, पहले इसे 5.3 कहा जाता था.
5.3 नंबर बदला गया, पहले इसे 5.2 कहा जाता था.
9.1 चिपकाए गए लिंक को अटैचमेंट में अपग्रेड करने का सुझाव जोड़ा गया है.
9.2 प्रोग्राम के हिसाब से कोर्सवर्क असाइनमेंट बनाते समय, डिफ़ॉल्ट रूप से ऐड-ऑन अटैचमेंट बनाने का सुझाव जोड़ा गया.
2.6, 3.7, 3.8, 6.2, 7.3, 7.4 हटाया गया.
वर्शन 0.3 22 नवंबर, 2022 को अपडेट किया गया
2.3 लॉगिन करने के लिए दिए गए निर्देशों में सुधार किया गया है.
2.4 एक ऐसी स्थिति शामिल की गई है जिसमें hd को लागू करना ज़रूरी है.
3.2 "पाथ उपलब्ध कराएं" शब्द को फिर से लिखा गया.
5.5, 5.6, 6.3, 6.4, 7.5, 7.6 कोर्स की कॉपी ज़रूरी है. साथ ही, studentViewUri, teacherViewUri, और studentWorkReviewUri के लिए, दिशा-निर्देश जोड़ने का सुझाव दिया गया है.
वर्शन 0.2 29 अक्टूबर, 2021 को अपडेट किया गया
1.3 टेक्स्ट में बदलाव किया गया है, ताकि मकसद साफ़ तौर पर पता चल सके.
3.1 "ऐड-ऑन को अपनी वेबसाइट पर मौजूद, GWM की अनुमति से जुड़े सामान्य दिशा-निर्देशों का पालन करना ज़रूरी है"
3.9 WCAG ने ज़रूरी से 'सुझाया गया' में बदलाव किया है.
5.1 'ज़रूरी है' को 'सुझाया गया' में बदला गया.
5.3 "अगर ऐड-ऑन iframe से बाहर पॉप आउट होते हैं, तो iframe में टास्क की झलक दिखनी चाहिए."
5.4 "अगर ऐड-ऑन, iframe से बाहर निकलता है, तो छात्र-छात्राओं को Classroom पर वापस जाने के लिए एक प्रॉम्प्ट दिखना चाहिए" जानकारी जोड़ी गई.
8.1 जोड़ा गया, "अगर डिवाइस इस पर काम नहीं करता है, तो उपयोगकर्ता को एक मैसेज दिखाना होगा कि इस डिवाइस पर यह सुविधा काम नहीं करती. आम तौर पर, यह बताएं कि इसमें कौनसे डिवाइस काम करते हैं."
8.2 छात्र-छात्राओं के लिए, मोबाइल से किए गए काम को ज़रूरी से बदलकर सुझाया गया कर दिया गया है.
वर्शन 0.1 22 सितंबर, 2021 को अपडेट किया गया
  शुरुआती रिलीज़.