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

वर्शन 1.1, 5 दिसंबर, 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) का इस्तेमाल करके, किसी उपयोगकर्ता को अगली बार आने पर, लॉगिन प्रॉम्प्ट दिखाए बिना अपने-आप साइन इन करना _होगा_. जब लॉगिन हिंट, फ़िलहाल साइन इन किए हुए उपयोगकर्ता से मैच नहीं करता है, तो ऐड-ऑन को उपयोगकर्ता को साइन-इन बटन के साथ प्रॉम्प्ट करना _होगा_. साथ ही, अमान्य खातों को फ़िल्टर करने के लिए, auth लाइब्रेरी को login_hint पास करना होगा.	ज़रूरी है
	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	ऐड-ऑन, सुलभता के लिए बने WCAG 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 लॉन्च करता है, तो यूआरएल को पार्टनर के मोबाइल के खास ऐप्लिकेशन या पार्टनर के मोबाइल वेब ऐप्लिकेशन में खोलना _होगा_. साथ ही, दोनों ही मामलों में, सही व्यू के लिए डीप-लिंक करना होगा. अगर डिवाइस पर Classroom का मोबाइल ऐप्लिकेशन काम नहीं करता है, तो उपयोगकर्ता को एक मैसेज दिखना _चाहिए_. इससे उसे पता चलेगा कि यह डिवाइस, Classroom के मोबाइल ऐप्लिकेशन के साथ काम नहीं करता. साथ ही, मैसेज में यह भी बताया जाना _चाहिए_ कि किन डिवाइसों पर Classroom का मोबाइल ऐप्लिकेशन काम करता है.	ज़रूरी है
	8.2	छात्र-छात्रा के काम को मोबाइल डिवाइस पर पूरा किया जा _सकता है_.	सुझाया गया
9.0	अतिरिक्त सुविधाएं
	9.1	अगर शिक्षक, लिंक अटैचमेंट के तौर पर आपके कॉन्टेंट के लिंक चिपका सकते हैं, तो आपको लिंक अपग्रेड करके, उन्हें ऐड-ऑन अटैचमेंट में बदलना चाहिए.	सुझाया गया
	9.2	अगर Classroom के बाहर से असाइनमेंट बनाने के लिए, कोर्सवर्क इंटिग्रेशन का इस्तेमाल किया जाता है, तो आपको अपने ऐड-ऑन के साथ काम करने वाले सभी लिंक के लिए, डिफ़ॉल्ट रूप से ऐड-ऑन अटैचमेंट बनाने _चाहिए_.	सुझाया गया

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

वर्शन 1.1	5 दिसंबर, 2024 को अपडेट किया गया
1.1, 1.3, 3.2, 3.10, 4.4, 5.2	ज़रूरी से बदलकर, सुझाया गया किया गया.
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 थी. ज़रूरी से बदलकर, सुझाया गया किया गया.
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	"अगर डिवाइस पर Classroom का मोबाइल ऐप्लिकेशन काम नहीं करता है, तो उपयोगकर्ता को एक मैसेज दिखना _चाहिए_. इससे उसे पता चलेगा कि यह डिवाइस, Classroom के मोबाइल ऐप्लिकेशन के साथ काम नहीं करता. साथ ही, मैसेज में यह भी बताया जाना _चाहिए_ कि किन डिवाइसों पर Classroom का मोबाइल ऐप्लिकेशन काम करता है." यह लाइन जोड़ी गई.
8.2	मोबाइल पर छात्र-छात्रा के काम को पूरा करने की सुविधा, ज़रूरी से बदलकर, सुझाया गया की गई.
वर्शन 0.1	22 सितंबर, 2021 को अपडेट किया गया
	शुरुआती रिलीज़.