- Yêu cầu HTTP
- Tham số đường dẫn
- Tham số truy vấn
- Nội dung yêu cầu
- Nội dung phản hồi
- Phạm vi uỷ quyền
Lấy siêu dữ liệu về các tiện ích bổ sung cho Google Lớp học trong ngữ cảnh của một bài đăng cụ thể.
Để duy trì tính toàn vẹn của mô hình dữ liệu và quyền, tiện ích bổ sung sẽ gọi hàm này để xác thực tham số truy vấn và vai trò của người dùng yêu cầu bất cứ khi nào 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
để 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
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
Tham số | |
---|---|
courseId |
Bắt buộc. Giá trị nhận dạng của khoá học. |
itemId |
Giá trị nhận dạng của thông báo,courseWork hoặc mẫucourseWorkMaterial mà tệp đính kèm sẽ được đí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
Tham số | |
---|---|
addOnToken |
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 là bắt buộc khi không có trường hợp nào sau đây đúng:
|
attachmentId |
Không bắt buộc. Giá trị nhận dạng của tệp đính kèm. Trường này là bắt buộc cho tất cả các yêu cầu trừ khi người dùng đang ở iframe của tính năng Khám phá tệp đính kèm. |
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.