يمكنك الإشارة إلى الدورات التدريبية باسم مختلف باستخدام اسم بديل للدورات التدريبية. يمكن أن تُستخدَم الأسماء البديلة للدورات التدريبية كعملية ربط بين معرّفات الدورات التدريبية في Google Classroom ومعرّفات الدورات التدريبية الخارجية. على سبيل المثال، يمكنك ضبط اسم بديل للدورة التدريبية لمطابقة رقم تعريف الدورة التدريبية من نظام معلومات الطالب (SIS).
يتوفّر اسم النطاق البديل للدورة التدريبية بشكلَين: على مستوى النطاق وعلى مستوى المشروع.
تستخدِم الأسماء البديلة على مستوى النطاق البادئة
d:
ويمكن لأي مستخدم يستخدم Classroom API الاطّلاع عليها. تكون مساحة أسماء النطاق مفيدة لإنشاء أسماء بديلة يحتاج جميع المستخدمين إلى الوصول إليها، ولكنّها ليست خاصة بأي برنامج. على سبيل المثال، يجب إنشاء بيانات بديلة لدورة تدريبية، مثل MATH 127 وCOMSCI 127، في مساحة اسم النطاق. لا يمكن لمشرفي النطاقات إلا إنشاء الأسماء المستعارة في مساحة имен النطاق، ولكن تكون هذه الأسماء مرئية لجميع المستخدمين في النطاق.تستخدم الأسماء البديلة على مستوى المشروع البادئة
p:
ولا يمكن سوى لمشروع Google Cloud الذي أنشأها الاطّلاع عليها واستخدامها. تكون مساحة اسم مشروع المطوّر مفيدة لإدارة الأسماء البديلة الخاصة بتطبيق معيّن. على سبيل المثال، يمكن لتطبيق يستخدم معرّفات بديلة لمواد التدريس إنشاء أسماء بديلة لربط معرّفه بمواد التدريس في Classroom. إنّ الأسماء البديلة التي تم إنشاؤها في مساحة الاسم هذه مرتبطة بمشروع محدّد على Google Cloud. يمكن لأي مستخدم لتطبيق إنشاء عناوين بديلة وعرضها في مساحة الاسم الخاصة بمشروع المطوّر لهذا التطبيق.
يمكن استخدام الاسم المعرِّف للدورة التدريبية بدلاً من معرّف الدورة التدريبية في Classroom لأي نقطة نهاية لواجهة برمجة التطبيقات Classroom API. وهذا يعني أنّه يمكن استخدام الاسم المعرِّف لقراءة معلومات الدورات التدريبية وقوائم الطلاب وتعديلها.
استخدام اسم بديل للمزامنة مع أنظمة معلومات الطلاب
يمكن تسجيل المعرّف الداخلي لدورة تدريبية في نظام معلومات الجامعات (SIS) كاسم مستعار على مستوى النطاق للدورة التدريبية. بهذه الطريقة، يمكن لأي مطوّر يدمج كلاً من نظام معلومات الطالب و Classroom استخدام معرّف نظام معلومات الطالب للتفاعل مع data Classroom.
إذا أنشأت دورة تدريبية من نظام إدارة معلومات الطلاب (SIS) أو ربطت دورة تدريبية بنظام إدارة معلومات الطلاب، ننصحك
باستخدام معرّف الدورة التدريبية في نظام إدارة معلومات الطلاب كعنوان بديل للدورة التدريبية. عند إنشاء
دورة تدريبية باستخدام الطريقة 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