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

इस पेज पर, 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 की डेवलपर के लिए उपलब्ध सुविधाओं में दी गई है. अगर आपको किसी निजी प्रीव्यू सुविधा को आज़माना है, तो हो सकता है कि आपको वह सुविधा किसी भी सार्वजनिक दस्तावेज़ में न दिखे.

आने वाली सुविधाएं

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

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

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

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

पिछले वर्शन

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

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

माइग्रेशन से जुड़ी गाइडलाइन देखें.

सुविधा	ब्यौरा	GA में शामिल किया गया	झलक बंद होने की तारीख	Preview Version
Rubrics CRUD	शिक्षकों की ओर से, क्लासरूम में रूब्रिक बनाएं, पढ़ें, अपडेट करें, और मिटाएं.	05 दिसंबर, 2024	01 अप्रैल, 2025	V1_20231110_PREVIEW
ग्रेडिंग पीरियड	एडमिन और शिक्षकों की ओर से ग्रेडिंग की अवधि बनाएं, पढ़ें, अपडेट करें, और मिटाएं.	08 अप्रैल, 2025	01 अगस्त, 2025	V1_20240401_PREVIEW
छात्र-छात्राओं के ग्रुप	एडमिन और शिक्षकों की ओर से, छात्र-छात्राओं के ग्रुप और उनके सदस्यों को मैनेज करना.	26 जनवरी, 2026	01 जून, 2026	V1_20250630_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()

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

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

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

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

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

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

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