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