معاينة الميزات وخطة العمل

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

تحتوي هذه الصفحة على معلومات عن الميزات القادمة لواجهة برمجة التطبيقات Classroom API وتفاصيل حول كيفية المشاركة في الإصدار التجريبي للمطوّرين.

معاينة Classroom API

من خلال معاينة ميزات Classroom API، يمكن للمطوّرين التأثير في شكل تطوير الميزات من خلال تقديم الملاحظات وطرح دمجاتهم للاستخدام العام قبل طرحها للجميع.

مراحل النشاط في المعاينة

يمكن للمطوّرين تفعيل إصدارات من واجهة برمجة التطبيقات تحتوي على ميزات جديدة متوافقة مع الإصدارات القديمة. تكون هذه "الإصدارات التجريبية" متاحة للجميع لمدة 90 يومًا على الأقل. استنادًا إلى الملاحظات والآراء، يتم دمج إصدار المعاينة وميزاته في واجهة برمجة التطبيقات الحالية من الإصدار 1. تظل الإصدارات التجريبية متاحة لمدة 90 يومًا أخرى على الأقل قبل إيقافها نهائيًا.

إذا كانت الملاحظات الواردة بشأن إصدار المعاينة قوية بما يكفي لتطلب إجراء تغييرات جذرية، يتم إنشاء إصدار جديد يتيح استخدام الإمكانات الحالية. يظل كلا الإصدارين متاحَين لمدة 90 يومًا على الأقل للسماح للمطوّرين بنقل البيانات. يمكنك الانضمام إلى القائمة البريدية لإصدار Classroom API للمعاينة من المطوّرين للاطّلاع على آخر الأخبار المتعلّقة بالتغييرات في المعاينة والاشتراك في قائمة الإشعارات للحصول على مزيد من التحديثات العامة حول Classroom API.

المشاركة في معاينات Classroom API

للمشاركة، يمكنك الانضمام إلى برنامج الإصدار التجريبي للمطوّرين في Google Workspace. يتم إدراج الميزات التجريبية المتاحة للجميع في الميزات التجريبية النشطة للمطوّرين في Google Workspace. إذا كنت تختبر ميزة اطّلاع خاصة، قد لا تظهر لك هذه الميزة مُدرَجة في أي مستندات عامة.

الميزات القادمة

في ما يلي خارطة الطريق التي توضّح الميزات المتوقّعة لواجهة برمجة التطبيقات والجداول الزمنية لها. ويتم تعديله بصورة دورية.

تمثّل قيمة إصدار المعاينة التاريخ المتوقّع لتوفّر الإصدار في مرحلة المعاينة الأولية. اطّلِع على الوصول إلى واجهات برمجة التطبيقات التجريبية للتعرّف على كيفية استخدام الإصدارات التجريبية.

الإصدارات السابقة

بعد التحقّق من الميزات الجديدة، يتم دمجها في واجهة برمجة التطبيقات v1 ويتم إيقاف إصدار المعاينة المقابل. سيتوفّر للمطوّرين مهلة 90 يومًا على الأقل للقيام بعملية نقل البيانات قبل إيقاف إصدار المعاينة.

إرشادات نقل البيانات

بعد دمج الميزات من إصدار تجريبي في واجهة برمجة التطبيقات من الإصدار 1، أزِل 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()

لنقل البيانات إلى الإصدار 1 من "إحصاءات Google‏ API"، عليك إزالة الوسيطة previewVersion:

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

إذا كنت تستخدم مكتبة برامج عملاء تم إنشاؤها بشكل ثابت بغرض الوصول إلى ميزة معيّنة في إصدار المعاينة، ولم تكن تستخدم ميزات واجهة برمجة تطبيقات أخرى في المعاينة، يمكنك الانتقال إلى مكتبة برامج العملاء التلقائية بلغتك. اطّلِع على مقالة الوصول إلى واجهات برمجة التطبيقات في مرحلة المعاينة لمعرفة المزيد من المعلومات.

الملاحظات

يمكنك مشاركة ملاحظاتك حول ميزات المعاينة من خلال أداة تتبُّع المشاكل المرتبطة في قسم معاينات المطوّرين النشطين ضمن صفحة النظرة العامة على "برنامج معاينة المطوّرين في Google Workspace".

استخدام ميزات معاينة Classroom API في مرحلة الإنتاج

إذا كنت تريد استخدام ميزات معاينة Classroom API مع المستخدمين النهائيين، بما في ذلك أي معلّمين أو مشرفين أو طلاب حقيقيين، يجب الموافقة على تعديل خاص بمنصة Classroom على بنود برنامج معاينة المطوّرين في Google Workspace، وذلك من خلال إكمال هذا النموذج وإرساله: