تتوفّر الآن إضافات Google Classroom بشكل عام للمطوّرين. يُرجى الاطّلاع على
مستندات الإضافات للحصول على مزيد من المعلومات.
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 حرفًا.
|
الطُرق |
|
|
لإنشاء اسم بديل لدورة تدريبية |
|
|
لحذف عنوان بديل لدورة تدريبية |
|
|
لعرض قائمة بالأسماء البديلة لدورة تدريبية. |
إنّ محتوى هذه الصفحة مرخّص بموجب ترخيص Creative Commons Attribution 4.0 ما لم يُنصّ على خلاف ذلك، ونماذج الرموز مرخّصة بموجب ترخيص Apache 2.0. للاطّلاع على التفاصيل، يُرجى مراجعة سياسات موقع Google Developers. إنّ Java هي علامة تجارية مسجَّلة لشركة Oracle و/أو شركائها التابعين.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)"],[],[],null,["# REST Resource: courses.aliases\n\n- [Resource: CourseAlias](#CourseAlias)\n - [JSON representation](#CourseAlias.SCHEMA_REPRESENTATION)\n- [Methods](#METHODS_SUMMARY)\n\nResource: CourseAlias\n---------------------\n\nAlternative identifier for a course.\n\nAn alias uniquely identifies a course. It must be unique within one of the following scopes:\n\n- domain: A domain-scoped alias is visible to all users within the alias creator's domain and can be created only by a domain admin. A domain-scoped alias is often used when a course has an identifier external to Classroom.\n\n- project: A project-scoped alias is visible to any request from an application using the Developer Console project ID that created the alias and can be created by any project. A project-scoped alias is often used when an application has alternative identifiers. A random value can also be used to avoid duplicate courses in the event of transmission failures, as retrying a request will return `ALREADY_EXISTS` if a previous one has succeeded.\n\n| JSON representation |\n|-----------------------------|\n| ``` { \"alias\": string } ``` |\n\n| Fields ||\n|---------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `alias` | `string` Alias string. The format of the string indicates the desired alias scoping. - `d:\u003cname\u003e` indicates a domain-scoped alias. Example: `d:math_101` - `p:\u003cname\u003e` indicates a project-scoped alias. Example: `p:abc123` This field has a maximum length of 256 characters. |\n\n| Methods ------- ||\n|-----------------------------------------------------------------------------|-----------------------------------------|\n| ### [create](/workspace/classroom/reference/rest/v1/courses.aliases/create) | Creates an alias for a course. |\n| ### [delete](/workspace/classroom/reference/rest/v1/courses.aliases/delete) | Deletes an alias of a course. |\n| ### [list](/workspace/classroom/reference/rest/v1/courses.aliases/list) | Returns a list of aliases for a course. |"]]
