Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem
tài liệu về tiện ích bổ sung để biết thêm thông tin.
Method: courses.aliases.create
Sử dụng bộ sưu tập để sắp xếp ngăn nắp các trang
Lưu và phân loại nội dung dựa trên lựa chọn ưu tiên của bạn.
Tạo bí danh cho một khoá học.
Phương thức này trả về các mã lỗi sau:
PERMISSION_DENIED nếu người dùng yêu cầu không được phép tạo bí danh hoặc do lỗi truy cập.NOT_FOUND nếu khoá học không tồn tại.ALREADY_EXISTS nếu bí danh đã tồn tại.FAILED_PRECONDITION nếu bí danh được yêu cầu không phù hợp với người dùng hoặc khoá học yêu cầu (ví dụ: nếu người dùng không thuộc miền cố gắng truy cập vào bí danh ở phạm vi miền).
Yêu cầu HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
courseId |
string
Giá trị nhận dạng của khoá học cần đặt bí danh. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc alias.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của CourseAlias.
Nội dung phản hồi
Nếu thành công, nội dung phản hồi sẽ chứa một thực thể CourseAlias mới tạo.
Phạm vi uỷ quyền
Yêu cầu phạm vi OAuth sau:
https://www.googleapis.com/auth/classroom.courses
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-07-25 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-07-25 UTC."],[],[],null,["# Method: courses.aliases.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n- [Try it!](#try-it)\n\nCreates an alias for a course.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` if the requesting user is not permitted to create the alias or for [access errors](/workspace/classroom/reference/Access.Errors).\n- `NOT_FOUND` if the course does not exist.\n- `ALREADY_EXISTS` if the alias already exists.\n- `FAILED_PRECONDITION` if the alias requested does not make sense for the requesting user or course (for example, if a user not in a domain attempts to access a domain-scoped alias).\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/aliases`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Identifier of the course to alias. This identifier can be either the Classroom-assigned identifier or an [alias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias). |\n\n### Request body\n\nThe request body contains an instance of [CourseAlias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [CourseAlias](/workspace/classroom/reference/rest/v1/courses.aliases#CourseAlias).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.courses`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
