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