REST Resource: courses.aliases

المرجع: عنوان البريد الإلكتروني البديل للدورة التدريبية

تمثّل هذه السمة معرّفًا بديلاً للدورة التدريبية.

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

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

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

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

string

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

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

لا يزيد طول هذا الحقل عن 256 حرفًا.

الطُرق

create

 يُنشئ اسمًا مستعارًا للدورة التدريبية.

delete

 تحذف الاسم المستعار للدورة التدريبية.

list

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