Method: courses.courseWork.addOnAttachments.create

Tạo tệp đính kèm bằng tiện ích bổ sung dưới bài đăng.

Yêu cầu tiện ích bổ sung phải 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 để biết 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 đã xác định không tồn tại.

Yêu cầu HTTP

POST https://classroom.googleapis.com/v1/courses/{courseId}/courseWork/{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. 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

Thông số
postId
(deprecated)

string

Không bắt buộc. Không dùng nữa, chuyển sang 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.

Bạn phải có mã thông báo uỷ quyền này khi tạo tệp đính kèm trong Lớp học, nhưng không bắt buộc khi 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 khi 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 gốc 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ể mới 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.