सुविधाओं और रोडमैप की झलक

इस पेज पर, Classroom API की आने वाली सुविधाओं के बारे में जानकारी दी गई है. साथ ही, डेवलपर प्रीव्यू में हिस्सा लेने के तरीके के बारे में भी बताया गया है.

Classroom API की झलक देखना

Classroom API की सुविधाओं की झलक देखने से, डेवलपर को सुझाव/राय/शिकायत देने का मौका मिलता है. इससे, वे सुविधा को बेहतर बनाने में मदद कर सकते हैं. साथ ही, सार्वजनिक तौर पर उपलब्ध होने से पहले, इंटिग्रेशन को सार्वजनिक इस्तेमाल के लिए तैयार कर सकते हैं.

झलक की लाइफ़साइकल

डेवलपर, एपीआई के उन वर्शन के लिए ऑप्ट-इन कर सकते हैं जिनमें नई और पुराने वर्शन के साथ काम करने वाली सुविधाएं शामिल हैं. ये "झलक वाले वर्शन", कम से कम 90 दिनों तक सार्वजनिक तौर पर उपलब्ध रहते हैं. इसके बाद, झलक वाले वर्शन और उसकी सुविधाओं को मौजूदा v1 एपीआई में शामिल किया जाता है. हालांकि, ऐसा फ़ीडबैक के आधार पर किया जाता है. झलक वाले वर्शन, बंद होने से पहले कम से कम 90 दिनों तक उपलब्ध रहते हैं.

अगर झलक वाले वर्शन के बारे में ज़रूरत के मुताबिक सुझाव, शिकायत या राय मिलती है, तो मौजूदा सुविधाओं के साथ काम करने के लिए नया वर्शन बनाया जाता है. डेवलपर को माइग्रेशन की सुविधा देने के लिए, दोनों वर्शन कम से कम 90 दिनों तक उपलब्ध रहेंगे. झलक में किए गए बदलावों के बारे में अप-टू-डेट रहने के लिए, Classroom API के डेवलपर के लिए झलक की मेलिंग सूची में शामिल हों. साथ ही, Classroom API से जुड़े सामान्य अपडेट पाने के लिए, सूचना सूची की सदस्यता लें.

ध्यान दें: झलक वाले वर्शन कुछ समय के लिए उपलब्ध होते हैं. ऐसा तब किया जाता है, जब v1 एपीआई में सामान्य तौर पर उपलब्ध कराने के लिए, सुविधाओं की पुष्टि की जा रही हो. प्रीव्यू वर्शन बंद होने के बाद, उसके व्यवहार में बदलाव हो सकता है.

Classroom API की झलक देखने की सुविधा में हिस्सा लेना

इसमें हिस्सा लेने के लिए, Google Workspace के Developer Preview Program में शामिल हों. Public Preview की उपलब्ध सुविधाओं की सूची, Google Workspace के ऐक्टिव डेवलपर प्रीव्यू में दी गई है. अगर निजी झलक की सुविधा को टेस्ट किया जा रहा है, तो हो सकता है कि आपको वह सुविधा किसी भी सार्वजनिक दस्तावेज़ में न दिखे.

लॉन्च की जाने वाली सुविधाएं

यहां एपीआई की संभावित सुविधाओं और उनकी समयावधि का रोडमैप दिया गया है. इसे समय-समय पर अपडेट किया जाता है.

झलक वाले वर्शन की वैल्यू से पता चलता है कि वर्शन की झलक पहली बार कब उपलब्ध होगी. झलक वाले वर्शन का इस्तेमाल करने का तरीका जानने के लिए, झलक वाले एपीआई ऐक्सेस करना लेख पढ़ें.

ध्यान दें: रोडमैप की तारीखें टारगेट हैं और इनमें बदलाव हो सकता है. इसी तरह, हो सकता है कि रिलीज़ होने से पहले के वर्शन के आइडेंटिफ़ायर से, उस वर्शन के उपलब्ध होने की सटीक तारीख की जानकारी न मिले.

सुविधा	ब्यौरा	झलक के लिए टारगेट	GA के लिए टारगेट	Preview Version
उपयोगकर्ता की क्षमताएं	यह देखना कि किसी उपयोगकर्ता के पास Classroom की कुछ सुविधाओं का ऐक्सेस है या नहीं.	साल 2024 की चौथी तिमाही	साल 2025 की पहली छमाही	V1_20240930_PREVIEW
छात्र-छात्राओं के ग्रुप	एडमिन और शिक्षकों की ओर से, छात्र-छात्राओं के ग्रुप और उनके सदस्यों को मैनेज करना.	साल 2025 की तीसरी तिमाही	अभी तय नहीं है	अभी तय नहीं है

पिछले वर्शन

नई सुविधाओं की पुष्टि होने के बाद, उन्हें v1 API में शामिल कर लिया जाता है और उससे जुड़े झलक वाले वर्शन को बंद कर दिया जाता है. झलक वाले वर्शन के बंद होने से पहले, डेवलपर के पास माइग्रेट करने के लिए कम से कम 90 दिन होते हैं.

अहम जानकारी: हो सकता है कि झलक वाले वर्शन बंद करने के लिए एपीआई कॉल, उम्मीद के मुताबिक काम न करें. आम तौर पर, काम न करने वाले प्रीव्यू वर्शन के एपीआई कॉल को, एपीआई के V1 वर्शन के व्यवहार के साथ अपने-आप जवाब देना चाहिए. हालांकि, हमारा सुझाव है कि अनचाहे रुकावटों से बचने के लिए, बंद किए गए प्रीव्यू एपीआई वर्शन को पहले से माइग्रेट कर लें. ज़्यादा जानने के लिए, डेटा को दूसरी जगह भेजने से जुड़ी गाइड देखें.

सुविधा	ब्यौरा	GA में शामिल किया गया	टारगेट की झलक बंद होने की तारीख	Preview Version
Rubrics CRUD	शिक्षकों की ओर से, कक्षा के लिए रूब्रिक बनाएं, पढ़ें, अपडेट करें, और मिटाएं.	05 दिसंबर, 2024	1 अप्रैल, 2025	V1_20231110_PREVIEW
ग्रेडिंग पीरियड	एडमिन और शिक्षकों की ओर से, ग्रेड देने की अवधियां बनाएं, पढ़ें, अपडेट करें, और मिटाएं.	8 अप्रैल, 2025	1 अगस्त, 2025	V1_20240401_PREVIEW

माइग्रेशन से जुड़े दिशा-निर्देश

झलक वाले वर्शन की सुविधाओं को v1 API में शामिल करने के बाद, उससे जुड़े एपीआई कॉल से previewVersion आर्ग्युमेंट हटा दें. इससे यह पक्का किया जा सकेगा कि आपका ऐप्लिकेशन उम्मीद के मुताबिक काम करता रहे. उदाहरण के लिए, अगर V1_20231110_PREVIEW वर्शन में उपलब्ध, रूब्रिक बनाने की सुविधाओं को ऐक्सेस किया जा रहा था, तो आपके एपीआई कॉल इस तरह दिख सकते थे:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        # Specify the preview version. Rubrics CRUD capabilities are
        # supported in V1_20231110_PREVIEW and later.
        previewVersion="V1_20231110_PREVIEW"
        ).execute()

GA API के वर्शन 1 पर माइग्रेट करने के लिए, previewVersion आर्ग्युमेंट हटाएं:

rubric = service.courses().courseWork().rubrics().create(
        courseId=course_id, courseWorkId=coursework_id, body=body,
        ).execute()

अगर आपने झलक वाले वर्शन की किसी सुविधा को ऐक्सेस करने के लिए, खास तौर पर स्टैटिक तौर पर जनरेट की गई क्लाइंट लाइब्रेरी का इस्तेमाल किया था और झलक वाले एपीआई की अन्य सुविधाओं का इस्तेमाल नहीं किया जा रहा है, तो अपनी भाषा के लिए डिफ़ॉल्ट क्लाइंट लाइब्रेरी पर स्विच करें. ज़्यादा जानने के लिए, झलक देखने की सुविधा देने वाले एपीआई ऐक्सेस करना लेख पढ़ें.

सुझाव/राय दें या शिकायत करें

Google Workspace के डेवलपर के लिए उपलब्ध, झलक देखने की सुविधाओं के बारे में सुझाव/राय दें या शिकायत करें. इसके लिए, Google Workspace के डेवलपर के लिए उपलब्ध, झलक देखने की सुविधाओं के प्रोग्राम की खास जानकारी वाले पेज पर, डेवलपर के लिए उपलब्ध झलक सेक्शन में, लिंक किए गए IssueTracker का इस्तेमाल करें.

प्रोडक्शन में Classroom API की झलक देखने की सुविधाओं का इस्तेमाल करना

अगर आपको Classroom API की झलक वाली सुविधाओं को असली उपयोगकर्ताओं के साथ इस्तेमाल करना है, तो आपको Google Workspace के डेवलपर के लिए झलक वाले प्रोग्राम की शर्तों में, Classroom से जुड़े बदलाव के लिए सहमति देनी होगी. इसके लिए, यह फ़ॉर्म भरकर सबमिट करें: