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

वर्शन 1.1, 5 दिसंबर, 2024.

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

इस दस्तावेज़ में दिए गए मुख्य शब्दों "ज़रूरी है", "ज़रूरी नहीं है", "ज़रूरी है", "ज़रूरी है", "ज़रूरी नहीं है", "होना चाहिए", "नहीं होना चाहिए", "सुझाया गया", "हो सकता है", और "ज़रूरी नहीं है" का मतलब वही है जो RFC 2119 में बताया गया है.

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

आईडी टाइप
1.0 असली उपयोगकर्ता के लिए लाइसेंस (अगर लागू हो)
  1.1 जब उपयोगकर्ता के पास लाइसेंस न हो, तो उसे काम का मैसेज दिखाया जाना चाहिए. मैसेज में साफ़ तौर पर यह बताया जाना चाहिए कि ऐड-ऑन का इस्तेमाल क्यों नहीं किया जा सकता. साथ ही, उपयोगकर्ता को समस्या ठीक करने के लिए सुझाव दिया जाना चाहिए. सुझाया गया
  1.3 ऐड-ऑन के लिए Google Workspace Marketplace की लिस्टिंग में, लाइसेंस और सदस्यता से जुड़ी ज़रूरी शर्तों के बारे में जानकारी दी जानी चाहिए. इन शर्तों को पूरा करने के बाद ही ऐड-ऑन का इस्तेमाल किया जा सकता है. अगर ऐड-ऑन के लिए पैसे चुकाने पड़ते हैं, तो Marketplace की लिस्टिंग में ऐसे वेब पेज का लिंक होना चाहिए जिस पर कीमत या सेल्सपर्सन से संपर्क करने के तरीके के बारे में ज़्यादा जानकारी दी गई हो. सुझाया गया
2.0 असली उपयोगकर्ता के लिए साइन-इन करने की सुविधा
  2.1 शिक्षक के तौर पर ऐड-ऑन का इस्तेमाल करने वाले लोगों को, Google के एसएसओ (SSO) का इस्तेमाल करके ऐड-ऑन में साइन इन करना होगा.
अगर छात्र-छात्राओं को ऐड-ऑन में साइन इन करने के लिए कहा जाता है, तो उन्हें Google के एसएसओ (SSO) का इस्तेमाल करके साइन इन करना होगा.		 ज़रूरी है
  2.2 ऐड-ऑन को Google एसएसओ का इस्तेमाल करना चाहिए, ताकि अगली बार आने पर उपयोगकर्ता को लॉगिन प्रॉम्प्ट दिखाए बिना, अपने-आप साइन इन किया जा सके.
जब लॉगिन हिंट, मौजूदा समय में साइन इन किए गए उपयोगकर्ता से मेल नहीं खाता है, तो ऐड-ऑन को उपयोगकर्ता को साइन इन बटन दिखाना चाहिए. साथ ही, अमान्य खातों को फ़िल्टर करने के लिए, auth लाइब्रेरी को login_hint पास करना चाहिए.		 ज़रूरी है
  2.7 अगर Classroom का उपयोगकर्ता, ऐड-ऑन में पहले से साइन इन नहीं है (लॉगिन हिंट देखकर इसका पता लगाया जाता है), तो ऐड-ऑन को 'Google से साइन इन करें' बटन दिखाना होगा. इससे उपयोगकर्ता को साइन इन करने की प्रोसेस शुरू करने का विकल्प मिलेगा.
ध्यान दें: Google के ब्रैंडिंग दिशा-निर्देशों का पालन करने के लिए ऐसा करना ज़रूरी है. इससे पॉप-अप ब्लॉक करने वाले सॉफ़्टवेयर से बचने में भी मदद मिलती है.		 ज़रूरी है
  2.8 ऐड-ऑन में यह जानकारी दिखनी चाहिए कि फ़िलहाल साइन इन किया हुआ उपयोगकर्ता कौन है. सुझाया गया
3.0 सामान्य
  3.1 ऐड-ऑन को Google Workspace Marketplace से मंज़ूरी पाने के सामान्य दिशा-निर्देशों का पालन करना होगा. ज़रूरी है
  3.2 अगर किसी iframe से नए टैब या विंडो में कोई टास्क लॉन्च किया जाता है, तो उसे Classroom पर वापस जाने के लिए, उपयोगकर्ता के लिए आसान मैसेज दिखाना चाहिए. सुझाया गया
  3.3 उपयोगकर्ता को सिर्फ़ ऐड-ऑन के वर्कफ़्लो का इस्तेमाल करके, असाइनमेंट पूरा करना होगा. उसे courseWork के वर्कफ़्लो पर स्विच नहीं करना चाहिए. साथ ही, उसे Classroom के शेयर बटन का इस्तेमाल नहीं करना चाहिए. ज़रूरी है
  3.4 भाषा चुनने का विकल्प: अगर ब्राउज़र में स्थानीय भाषा की प्राथमिकता सेट की गई है, तो भाषा उसी के हिसाब से होनी चाहिए. सुझाया गया
  3.5 अगर कोई ऐड-ऑन maxPoints को तय करता है, तो उसे pointsEarned को भी सेट करना होगा. ऐसा तब करना होगा, जब कोई छात्र या छात्रा, शिक्षक के सेव किए गए क्रेडेंशियल का इस्तेमाल करके सबमिशन पूरा करता है (सुझाया गया) या जब शिक्षक, छात्र या छात्रा के काम की समीक्षा करने वाले iframe में सबमिशन खोलता है. ज़रूरी है
  3.9 ऐड-ऑन, सुलभता से जुड़े डब्ल्यूसीएजी 2.1 लेवल AA के दिशा-निर्देशों के मुताबिक होने चाहिए. ऐड-ऑन डेवलपर, ऐड-ऑन सबमिट करते समय खुद ही यह रिपोर्ट करेंगे कि यह ज़रूरी शर्त पूरी हो गई है. साथ ही, यह भी बताएंगे कि ऐड-ऑन में आने वाले समय में होने वाले बदलावों के हिसाब से, ऐड-ऑन अब भी इस ज़रूरी शर्त का पालन करता है. सुझाया गया
  3.10 उपयोगकर्ता को दिखने वाली गड़बड़ियों के मैसेज, पढ़ने में आसान होने चाहिए. सुझाया गया
  3.11 अगर 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 अगर गतिविधि में सबमिट करें लेबल वाला बटन या लिंक मौजूद है, तो उस पर क्लिक करने से एपीआई का अनुरोध ज़रूर होना चाहिए. इससे शिक्षक को छात्र-छात्रा का काम सबमिट किया जा सके, ताकि वह उसकी समीक्षा कर सके. ज़रूरी है
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.1 5 दिसंबर, 2024 को अपडेट किया गया
1.1, 1.3, 3.2, 3.10, 4.4, 5.2 इसे REQUIRED से बदलकर RECOMMENDED कर दिया गया है.
3.12 हटाया गया.
5.3 फिर से लिखा गया. हाल ही में हुए बदलाव के बाद, ऐड-ऑन डेवलपर अब एपीआई का इस्तेमाल करके, छात्रों के सबमिट किए गए असाइनमेंट को भरोसेमंद तरीके से चालू कर सकते हैं.
संस्करण 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 था. इसे REQUIRED से बदलकर RECOMMENDED भी कर दिया गया है.
4.4 नया नंबर दिया गया है. पहले यह 4.3 था.
4.5 इसे फिर से नंबर दिया गया है. पहले यह 4.4 था.
5.2 नया नंबर दिया गया है. पहले यह 5.3 था.
5.3 नया नंबर दिया गया है. पहले यह 5.2 था.
9.1 चिपकाए गए लिंक को अटैचमेंट में अपग्रेड करने का सुझाव जोड़ा गया है.
9.2 प्रोग्राम के हिसाब से CourseWork असाइनमेंट बनाते समय, डिफ़ॉल्ट रूप से ऐड-ऑन अटैचमेंट बनाने का सुझाव जोड़ा गया.
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 ने REQUIRED को RECOMMENDED में बदल दिया है.
5.1 REQUIRED को RECOMMENDED में बदल दिया गया है.
5.3 "अगर ऐड-ऑन, iframe से बाहर दिखता है, तो iframe में टास्क के बारे में एक झलक दिखनी चाहिए." जोड़ा गया.
5.4 "अगर ऐड-ऑन iframe से बाहर निकल जाता है, तो छात्र-छात्राओं को Classroom पर वापस जाने के लिए एक प्रॉम्प्ट दिखना चाहिए." जोड़ा गया
8.1 "अगर डिवाइस पर यह सुविधा काम नहीं करती है, तो उपयोगकर्ता को एक मैसेज दिखाया जाना चाहिए. इससे उन्हें पता चलेगा कि यह सुविधा उनके डिवाइस पर काम नहीं करती. साथ ही, उन्हें यह भी पता चलेगा कि यह सुविधा किन डिवाइसों पर काम करती है." यह जानकारी जोड़ी गई.
8.2 मोबाइल पर छात्र-छात्राओं के काम को 'ज़रूरी है' से बदलकर 'सुझाया गया' के तौर पर मार्क किया गया.
वर्शन 0.1 22 सितंबर, 2021 को अपडेट किया गया
  शुरुआती रिलीज़.