نام مستعار به طور منحصر به فرد یک دوره را مشخص می کند. باید در یکی از حوزه های زیر منحصر به فرد باشد:
دامنه: یک نام مستعار با دامنه دامنه برای همه کاربران در دامنه ایجاد کننده نام مستعار قابل مشاهده است و فقط توسط یک مدیر دامنه می تواند ایجاد شود. نام مستعار دامنه‌دار اغلب زمانی استفاده می‌شود که یک دوره دارای شناسه‌ای خارج از Classroom باشد.
پروژه: یک نام مستعار با محدوده پروژه برای هر درخواستی از یک برنامه با استفاده از شناسه پروژه کنسول برنامه‌نویس که نام مستعار را ایجاد کرده است قابل مشاهده است و می‌تواند توسط هر پروژه ایجاد شود. نام مستعار محدوده پروژه اغلب زمانی استفاده می شود که یک برنامه دارای شناسه های جایگزین باشد. همچنین می‌توان از یک مقدار تصادفی برای اجتناب از دوره‌های تکراری در صورت عدم موفقیت در انتقال استفاده کرد، زیرا اگر درخواست قبلی موفق شده باشد، درخواست مجدد ALREADY_EXISTS برمی‌گرداند.
نمایندگی JSON
{"alias": string}
فیلدها
alias
string
رشته مستعار. قالب رشته نشان دهنده دامنه نام مستعار مورد نظر است.
d:<name> یک نام مستعار با دامنه دامنه را نشان می دهد. مثال: d:math_101
p:<name> یک نام مستعار با محدوده پروژه را نشان می دهد. مثال: p:abc123
تاریخ آخرین بهروزرسانی 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. |"]]
