افزونه های Google Classroom اکنون به طور کلی در دسترس توسعه دهندگان هستند! لطفاً برای اطلاعات بیشتر به
اسناد افزونه ها مراجعه کنید.
REST Resource: courses.aliases
با مجموعهها، منظم بمانید
ذخیره و طبقهبندی محتوا براساس اولویتهای شما.
منبع: CourseAlias
شناسه جایگزین برای یک دوره
نام مستعار به طور منحصر به فرد یک دوره را مشخص می کند. باید در یکی از حوزه های زیر منحصر به فرد باشد:
دامنه: یک نام مستعار با دامنه دامنه برای همه کاربران در دامنه ایجاد کننده نام مستعار قابل مشاهده است و فقط توسط یک مدیر دامنه می تواند ایجاد شود. نام مستعار دامنهدار اغلب زمانی استفاده میشود که یک دوره دارای شناسهای خارج از Classroom باشد.
پروژه: یک نام مستعار با محدوده پروژه برای هر درخواستی از یک برنامه با استفاده از شناسه پروژه کنسول برنامهنویس که نام مستعار را ایجاد کرده است قابل مشاهده است و میتواند توسط هر پروژه ایجاد شود. نام مستعار محدوده پروژه اغلب زمانی استفاده می شود که یک برنامه دارای شناسه های جایگزین باشد. همچنین میتوان از یک مقدار تصادفی برای اجتناب از دورههای تکراری در صورت عدم موفقیت در انتقال استفاده کرد، زیرا اگر درخواست قبلی موفق شده باشد، درخواست مجدد ALREADY_EXISTS
برمیگرداند.
نمایندگی JSON |
---|
{
"alias": string
} |
فیلدها |
---|
alias | string رشته مستعار. قالب رشته نشان دهنده دامنه نام مستعار مورد نظر است. -
d:<name> یک نام مستعار با دامنه دامنه را نشان می دهد. مثال: d:math_101 -
p:<name> یک نام مستعار با محدوده پروژه را نشان می دهد. مثال: p:abc123
حداکثر طول این فیلد 256 کاراکتر است. |
روش ها |
---|
| یک نام مستعار برای یک دوره ایجاد می کند. |
| نام مستعار یک دوره را حذف می کند. |
| فهرستی از نام های مستعار را برای یک دوره برمی گرداند. |
جز در مواردی که غیر از این ذکر شده باشد،محتوای این صفحه تحت مجوز Creative Commons Attribution 4.0 License است. نمونه کدها نیز دارای مجوز Apache 2.0 License است. برای اطلاع از جزئیات، به خطمشیهای سایت Google Developers مراجعه کنید. جاوا علامت تجاری ثبتشده 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. |"]]