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.announcements.addOnAttachments.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 tệp đính kèm có tiện ích bổ sung trong một bài đăng.
Yêu cầu tiện ích bổ sung có quyền tạo tệp đính kèm mới trên bài đăng.
Phương thức này trả về các mã lỗi sau:
PERMISSION_DENIED đối với lỗi truy cập.INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.NOT_FOUND nếu một trong các tài nguyên được xác định không tồn tại.
Yêu cầu HTTP
POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
| Thông số |
courseId |
string
Bắt buộc. Giá trị nhận dạng của khoá học.
|
itemId |
string
Giá trị nhận dạng của Announcement, CourseWork hoặc CourseWorkMaterial để tạo tệp đính kèm. Đây là trường bắt buộc, nhưng không được đánh dấu là bắt buộc trong khi chúng tôi di chuyển từ postId.
|
Tham số truy vấn
| Thông số |
postId
(deprecated) |
string
Không bắt buộc. Không dùng nữa, hãy sử dụng itemId.
|
addOnToken |
string
Không bắt buộc. Mã thông báo uỷ quyền cho yêu cầu. Mã thông báo được truyền dưới dạng tham số truy vấn khi người dùng được chuyển hướng từ Lớp học sang URL của tiện ích bổ sung. Mã thông báo uỷ quyền này là bắt buộc khi tạo tệp đính kèm trong Google Lớp học, nhưng không bắt buộc khi tạo tệp đính kèm do đối tác tạo trước. Trả về lỗi nếu không được cung cấp để tạo tệp đính kèm của đối tác và các dự án của nhà phát triển đã tạo tệp đính kèm và mục luồng mẹ của tệp đính kèm đó không khớp.
|
Nội dung yêu cầu
Nội dung yêu cầu chứa một bản sao của AddOnAttachment.
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ể AddOnAttachment 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.addons.teacher
Để 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.announcements.addOnAttachments.create\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n- [Authorization scopes](#body.aspect)\n\nCreates an add-on attachment under a post.\n\nRequires the add-on to have permission to create new attachments on the post.\n\nThis method returns the following error codes:\n\n- `PERMISSION_DENIED` for [access errors](/workspace/classroom/reference/Access.Errors).\n- `INVALID_ARGUMENT` if the request is malformed.\n- `NOT_FOUND` if one of the identified resources does not exist.\n\n### HTTP request\n\n`POST https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnAttachments`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|------------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `courseId` | `string` Required. Identifier of the course. |\n| `itemId` | `string` Identifier of the `Announcement`, `CourseWork`, or `CourseWorkMaterial` under which to create the attachment. This field is required, but is not marked as such while we are migrating from postId. |\n\n### Query parameters\n\n| Parameters ||\n|---------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `postId` **(deprecated)** | `string` Optional. Deprecated, use `itemId` instead. |\n| `addOnToken` | `string` Optional. Token that authorizes the request. The token is passed as a query parameter when the user is redirected from Classroom to the add-on's URL. This authorization token is required for in-Classroom attachment creation but optional for partner-first attachment creation. Returns an error if not provided for partner-first attachment creation and the developer projects that created the attachment and its parent stream item do not match. |\n\n### Request body\n\nThe request body contains an instance of [AddOnAttachment](/workspace/classroom/reference/rest/v1/courses.announcements.addOnAttachments#AddOnAttachment).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [AddOnAttachment](/workspace/classroom/reference/rest/v1/courses.announcements.addOnAttachments#AddOnAttachment).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/classroom.addons.teacher`\n\nFor more information, see the [Authorization guide](/workspace/guides/configure-oauth-consent)."]]
