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

इस पेज पर, 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
सीखने के लक्ष्य	कोर्स के लिए सीखने के स्टैंडर्ड और CourseWork और Rubrics के लिए सीखने के लक्ष्य सेट करें.	साल 2026 की तीसरी तिमाही	साल 2026 की चौथी तिमाही	V1_20260316_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 की डेवलपर के लिए झलक सुविधाओं का इस्तेमाल, असली शिक्षकों, एडमिन या छात्रों जैसे उपयोगकर्ताओं के साथ करना है, तो आपको Google Workspace के Developer Preview Program की शर्तों में Classroom से जुड़े संशोधन को स्वीकार करना होगा. इसके लिए, यह फ़ॉर्म भरें और सबमिट करें: