يحدِّد الاسم المعرِّف دورة دراسية بشكل فريد. يجب أن تكون فريدة ضمن أحد النطاقَين التاليَين:
النطاق: يكون الاسم المعرِّف على مستوى النطاق مرئيًا لجميع المستخدمين ضمن نطاق صانع الاسم المعرِّف، ولا يمكن إنشاؤه إلا من قِبل مشرف نطاق. غالبًا ما يتم استخدام الاسم المعرِّف على مستوى النطاق عندما يكون للدورة التدريبية معرّف خارجي خارج Classroom.
مشروع: يكون العنوان البديل على مستوى المشروع مرئيًا لأي طلب من تطبيق يستخدم رقم تعريف مشروع Developer Console الذي أنشأ العنوان البديل، ويمكن إنشاؤه من خلال أي مشروع. غالبًا ما يتم استخدام الاسم البديل على مستوى المشروع عندما يكون للتطبيق معرّفات بديلة. يمكن أيضًا استخدام قيمة عشوائية لتجنُّب تكرار الدورات التدريبية في حال حدوث أخطاء في الإرسال، لأنّ إعادة محاولة إرسال طلب سيؤدي إلى عرض القيمة ALREADY_EXISTS إذا تم إرسال طلب سابق بنجاح.
تمثيل JSON
{"alias": string}
الحقول
alias
string
سلسلة العنوان البديل يشير تنسيق السلسلة إلى نطاق الاسم المعرِّف المطلوب.
يشير الرمز d:<name> إلى اسم مستعار على مستوى النطاق. مثال: d:math_101
يشير الرمز p:<name> إلى عنوان بديل على مستوى المشروع. مثال: p:abc123
الحد الأقصى لعدد الأحرف في هذا الحقل هو 256 حرفًا.
تاريخ التعديل الأخير: 2025-07-25 (حسب التوقيت العالمي المتفَّق عليه)
[[["يسهُل فهم المحتوى.","easyToUnderstand","thumb-up"],["ساعَدني المحتوى في حلّ مشكلتي.","solvedMyProblem","thumb-up"],["غير ذلك","otherUp","thumb-up"]],[["لا يحتوي على المعلومات التي أحتاج إليها.","missingTheInformationINeed","thumb-down"],["الخطوات معقدة للغاية / كثيرة جدًا.","tooComplicatedTooManySteps","thumb-down"],["المحتوى قديم.","outOfDate","thumb-down"],["ثمة مشكلة في الترجمة.","translationIssue","thumb-down"],["مشكلة في العيّنات / التعليمات البرمجية","samplesCodeIssue","thumb-down"],["غير ذلك","otherDown","thumb-down"]],["تاريخ التعديل الأخير: 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. |"]]
