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

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