REST Resource: courses.aliases

المورد: CourseAlias

معرّف بديل لدورة دراسية

يحدِّد الاسم المعرِّف دورة دراسية بشكل فريد. يجب أن تكون فريدة ضمن أحد النطاقَين التاليَين:

  • النطاق: يكون الاسم المعرِّف على مستوى النطاق مرئيًا لجميع المستخدمين ضمن نطاق صانع الاسم المعرِّف، ولا يمكن إنشاؤه إلا من قِبل مشرف نطاق. غالبًا ما يتم استخدام الاسم المعرِّف على مستوى النطاق عندما يكون للدورة التدريبية معرّف خارجي خارج Classroom.

  • مشروع: يكون العنوان البديل على مستوى المشروع مرئيًا لأي طلب من تطبيق يستخدم رقم تعريف مشروع Developer Console الذي أنشأ العنوان البديل، ويمكن إنشاؤه من خلال أي مشروع. غالبًا ما يتم استخدام الاسم البديل على مستوى المشروع عندما يكون للتطبيق معرّفات بديلة. يمكن أيضًا استخدام قيمة عشوائية لتجنُّب تكرار الدورات التدريبية في حال حدوث أخطاء في الإرسال، لأنّ إعادة محاولة إرسال طلب سيؤدي إلى عرض القيمة ALREADY_EXISTS إذا تم إرسال طلب سابق بنجاح.

تمثيل JSON 
{
  "alias": string
}
الحقول
alias

string

سلسلة العنوان البديل يشير تنسيق السلسلة إلى نطاق الاسم المعرِّف المطلوب.

  • يشير الرمز d:<name> إلى اسم مستعار على مستوى النطاق. مثال: d:math_101
  • يشير الرمز p:<name> إلى عنوان بديل على مستوى المشروع. مثال: p:abc123

الحد الأقصى لعدد الأحرف في هذا الحقل هو 256 حرفًا.

الطُرق

create

 لإنشاء اسم بديل لدورة تدريبية

delete

 لحذف عنوان بديل لدورة تدريبية

list

 لعرض قائمة بالأسماء البديلة لدورة تدريبية.