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

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

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

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

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

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

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

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

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

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

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

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

पिछले वर्शन

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

डेटा को दूसरी जगह भेजने से जुड़ी गाइड

झलक वाले वर्शन की सुविधाओं को 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 के डेवलपर प्रीव्यू प्रोग्राम की खास जानकारी वाले पेज पर, डेवलपर के लिए उपलब्ध प्रीव्यू सेक्शन में, लिंक किए गए IssueTracker की मदद से, प्रीव्यू की सुविधाओं के बारे में सुझाव/राय दें या शिकायत करें.

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

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