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

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

معاينة Classroom API

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

الميزة	الوصف	مضمّنة في "إحصاءات Google"	تاريخ إيقاف المعاينة المستهدَف	إصدار المعاينة
عمليات الإنشاء والقراءة والتعديل والحذف لقواعد التقييم	إنشاء نماذج التقييم في الصفوف وتعديلها وحذفها وقراءتها نيابةً عن المعلّمين	‫05 ديسمبر 2024	‫1 أبريل 2025	V1_20231110_PREVIEW
فترات وضع الدرجات	إنشاء فترات التقييم وقراءتها وتعديلها وحذفها نيابةً عن المشرفين والمعلّمين	‫8 أبريل 2025	‫1 أغسطس 2025	V1_20240401_PREVIEW

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

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

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

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

الملاحظات

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

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

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