يمكنك الإشارة إلى الدورات التعليمية باسم مختلف باستخدام اسم مستعار للدورة التعليمية . يمكن أن تكون الأسماء المستعارة للدورات التعليمية بمثابة ربط بين معرّفات دورات Google Classroom ومعرّفات الدورات الخارجية. على سبيل المثال، يمكنك ضبط اسم مستعار للدورة التعليمية ليتطابق مع رقم تعريف الدورة التعليمية من نظام معلومات الطالب (SIS).
يتخذ الاسم المستعار للدورة التعليمية شكلَين: على مستوى النطاق وعلى مستوى المشروع.
تستخدم الأسماء المستعارة على مستوى النطاق البادئة
d:ويمكن لأي مستخدم استخدام Classroom API الاطّلاع عليها. تكون مساحة اسم النطاق مفيدة لإنشاء أسماء مستعارة يحتاج جميع المستخدمين إلى الوصول إليها، ولكنها ليست خاصة بأي برنامج واحد. على سبيل المثال، يجب إنشاء قوائم بديلة لدورة تعليمية، مثل MATH 127 وCOMSCI 127، في مساحة اسم النطاق. لا يمكن لمشرفي النطاق فقط إنشاء أسماء مستعارة في مساحة اسم النطاق، ولكن يمكن لجميع المستخدمين في النطاق الاطّلاع عليها.تستخدم الأسماء المستعارة على مستوى المشروع البادئة
p:ولا يمكن لمشروع Google Cloud الذي أنشأها إلا الاطّلاع عليها واستخدامها. تكون مساحة اسم مشروع المطوّر مفيدة لإدارة الأسماء المستعارة الخاصة بتطبيق معيّن. على سبيل المثال، يمكن لتطبيق يستخدم معرّفات بديلة للدورات التعليمية إنشاء أسماء مستعارة لربط المعرّف الخاص به بدورات Classroom. ترتبط الأسماء المستعارة التي يتم إنشاؤها في مساحة الاسم هذه بمشروع معيّن على Google Cloud. يمكن لأي مستخدم لتطبيق معيّن إنشاء الأسماء المستعارة وعرضها في مساحة الاسم الخاصة بمشروع المطوّر لهذا التطبيق.
يمكن استخدام اسم مستعار للدورة التعليمية بدلاً من رقم تعريف دورة Classroom لأي نقطة نهاية في Classroom API. وهذا يعني أنّه يمكن استخدام الاسم المستعار لقراءة الدورات التعليمية ومعلومات قائمة الطلاب المسجّلين وتعديلها.
استخدام اسم مستعار للمزامنة مع أنظمة معلومات الطالب
يمكن تسجيل المعرّف الداخلي لنظام معلومات الطالب لدورة تعليمية كاسم مستعار على مستوى النطاق للدورة التعليمية. وبهذه الطريقة، يمكن لأي مطوّر يدمج كلاً من نظام معلومات الطالب وClassroom استخدام معرّف نظام معلومات الطالب للتفاعل مع بيانات Classroom.
إذا أنشأت دورة تعليمية من نظام معلومات الطالب أو ربطت دورة تعليمية بنظام معلومات الطالب، ننصحك
باستخدام رقم تعريف الدورة التعليمية في نظام معلومات الطالب كاسم مستعار للدورة التعليمية. عند إنشاء دورة تعليمية باستخدام طريقة courses.create()، يمكنك تحديد الاسم المستعار في الحقل
id للطلب. إذا كان الاسم المستعار موجودًا من قبل، سيتعذّر إنشاء الدورة التعليمية وسيظهر الخطأ 409 ALREADY_EXISTS. يمنع ذلك إنشاء دورات تعليمية مكرّرة إذا حدثت مشكلة في برنامج المزامنة.
على سبيل المثال، إذا افترضنا أنّ اسم نظام معلومات الطالب هو school وأنّ المعرّف الداخلي
الذي يستخدمه نظام معلومات الطالب لدورة تعليمية معيّنة هو math_101، يمكنك إنشاء اسم مستعار
على النحو التالي: d:school_math_101.
إضافة اسم مستعار لدورة تعليمية جديدة
لإضافة اسم مستعار لدورة تعليمية جديدة، اضبط course.id على اسم مستعار عند
إجراء طلب courses.create().
برمجة التطبيقات
جافا
Python
إضافة اسم مستعار لدورة تعليمية حالية
لإضافة الاسم المستعار إلى دورة تعليمية حالية، يمكنك ضبط حقل alias
واستخدام طريقة courses.aliases.create().
برمجة التطبيقات
جافا
Python
استرداد الأسماء المستعارة للدورات التعليمية
يمكنك استرداد الأسماء المستعارة لدورة تعليمية باستخدام الـ
courses.aliases.list()، كما هو موضّح في الـ
مثال التالي:
NET.
جافا
Python