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

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

معاينة Classroom API

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

مراحل معاينة التطبيق

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

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

ملاحظة: يُفترض أن تكون إصدارات المعاينة مؤقتة أثناء التحقّق من الميزات لإتاحتها للجمهور العام في واجهة برمجة التطبيقات (API) من الإصدار 1. يخضع سلوك الإصدار التجريبي لعمليات تغيير بعد إيقافه.

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

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

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

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

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

ملاحظة: تواريخ خارطة الطريق هي تواريخ استهداف، وقد تخضع للتغيير. وبالمثل، قد لا تمثّل معرّفات إصدارات المعاينة التاريخ الدقيق الذي أصبح فيه إصدار متاحًا.

الميزة	الوصف	الاستهداف في المعاينة	الاستهداف في "إحصاءات Google"	إصدار المعاينة
فترات وضع الدرجات	إنشاء فترات التقييم وقراءتها وتعديلها وحذفها نيابةً عن المشرفين والمعلّمين	النصف الأول من عام 2024	TBD	V1_20240401_PREVIEW
إمكانات المستخدم	التحقّق مما إذا كان بإمكان أحد المستخدمين الوصول إلى ميزات معيّنة في Classroom	الربع الرابع من العام 2024	النصف الأول من عام 2025	V1_20240930_PREVIEW

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

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

ملاحظة مهمة: قد لا تعمل طلبات البيانات من واجهة برمجة التطبيقات لإيقاف الإصدارات التجريبية على النحو المتوقّع. بشكل عام، يجب أن تؤدي طلبات البيانات من واجهة برمجة التطبيقات التي تحدّد إصدارات المعاينة غير المتوافقة إلى الاستجابة تلقائيًا بسلوك واجهة برمجة التطبيقات v1، ولكننا ننصح بصفة استباقية بنقل البيانات من إصدارات واجهة برمجة التطبيقات الخاصة بالمعاينة التي سيتم إيقافها نهائيًا لتجنُّب الانقطاعات غير المتوقّعة. اطّلِع على إرشادات نقل البيانات لمعرفة المزيد من المعلومات.

الميزة	الوصف	تم دمجها في "إحصاءات Google"	تاريخ إيقاف المعاينة المستهدَفة	إصدار المعاينة
Rubrics CRUD	إنشاء وقراءة وتعديل وحذف معايير التقييم في الصفوف نيابةً عن المعلّمين	05 كانون الأول (ديسمبر) 2024	1 نيسان (أبريل) 2025	V1_20231110_PREVIEW

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

بعد دمج الميزات من إصدار تجريبي في واجهة برمجة التطبيقات من الإصدار 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، وذلك من خلال إكمال هذا النموذج وإرساله: