يمكنك الإشارة إلى الدورات التدريبية باسم مختلف باستخدام مورد Course Alias. أسماء الدبلومات البديلة هي عملية ربط بين معرّفات الدورات التدريبية في Google Classroom ومعرّفات الدورات التدريبية الخارجية.
ننصحك باستخدام رقم تعريف الدورة التدريبية في نظام إدارة المؤسسات التعليمية (SIS) كعنوان بديل للدورة التدريبية في أي وقت تنشئ فيه دورة تدريبية من نظام إدارة المؤسسات التعليمية (SIS) أو تربط دورة تدريبية بنظام إدارة المؤسسات التعليمية (SIS). تتيح لك واجهة برمجة التطبيقات 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