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

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

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

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

अहम जानकारी: इन ज़रूरी शर्तों में होने वाले बदलावों के बारे में सूचनाएं पाने के लिए, क्लासरूम-डेवलपर के एलान वाले ग्रुप में शामिल हों.

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

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