Method: courses.announcements.getAddOnContext

Lấy siêu dữ liệu cho các tiện ích bổ sung của Lớp học trong bối cảnh của một bài đăng cụ thể.

Để duy trì tính toàn vẹn của dữ liệu và mô hình quản lý quyền, tiện ích bổ sung sẽ gọi lệnh này để xác thực tham số truy vấn và vai trò của người dùng yêu cầu mỗi khi tiện ích bổ sung được mở trong iframe.

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

GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements/{itemId}/addOnContext

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 có 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ố
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ã uỷ quyền trong trường hợp không có trường hợp nào sau đây:

  • Tiện ích bổ sung này có tệp đính kèm trên bài đăng.
  • Dự án nhà phát triển đưa ra yêu cầu giống với dự án đã tạo bài đăng đó.

Nội dung yêu cầu

Nội dung yêu cầu phải trống.

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 phiên bản của AddOnContext.

Phạm vi uỷ quyền

Yêu cầu một trong các phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.addons.student
  • 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.