Method: courses.announcements.addOnAttachments.create

Tạo tệp đính kèm bằng tiện ích bổ sung bên dưới 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 do lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • Giá trị là NOT_FOUND nếu một trong những tài nguyên đã 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

Các tham 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 thông báo, CourseWork hoặc CourseWorkMaterial dùng để tạo tệp đính kèm. Trường này là bắt buộc, nhưng không được đánh dấu như vậy trong khi chúng ta di chuyển từ postId.

Tham số truy vấn

Các tham 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 cho phép yêu cầu.

Mã thông báo này được chuyể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 đến URL của tiện ích bổ sung.

Mã thông báo uỷ quyền này là bắt buộc để tạo tệp đính kèm trong Lớp học nhưng không bắt buộc để tạo tệp đính kèm ưu tiên đối tác. Trả về lỗi nếu không được cung cấp để tạo tệp đính kèm ưu tiên đố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 chính 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ể mới được tạo của AddOnAttachment.

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.