- 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
- Hãy làm thử!
Trả về danh sách các thông báo mà người yêu cầu được phép xem.
Học viên của khoá học chỉ có thể xem thông báo của PUBLISHED
. Giáo viên của khoá học và quản trị viên miền có thể xem tất cả thông báo.
Phương thức này trả về các mã lỗi sau:
PERMISSION_DENIED
nếu người dùng yêu cầu không được phép truy cập khoá học được yêu cầu hoặc do lỗi truy cập.INVALID_ARGUMENT
nếu yêu cầu không đúng định dạng.NOT_FOUND
nếu khoá học bạn yêu cầu không tồn tại.
Yêu cầu HTTP
GET https://classroom.googleapis.com/v1/courses/{courseId}/announcements
URL sử dụng cú pháp Chuyển mã gRPC.
Tham số đường dẫn
Các tham số | |
---|---|
courseId |
Giá trị nhận dạng của khoá học. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc |
Tham số truy vấn
Các tham số | |
---|---|
announcementStates[] |
Hạn chế đối với |
orderBy |
Thứ tự sắp xếp không bắt buộc đối với kết quả. Danh sách các trường được phân tách bằng dấu phẩy có từ khoá hướng sắp xếp không bắt buộc. Trường được hỗ trợ là |
pageSize |
Số lượng mục tối đa cần trả lại. Giá trị 0 hoặc không xác định cho biết máy chủ có thể chỉ định giá trị tối đa. Máy chủ có thể trả về ít kết quả hơn số kết quả đã chỉ định. |
pageToken |
Giá trị Yêu cầu |
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
Phản hồi khi liệt kê bài tập của khoá học.
Nếu thành công, phần nội dung phản hồi sẽ chứa dữ liệu có cấu trúc sau:
Biểu diễn dưới dạng JSON |
---|
{
"announcements": [
{
object ( |
Các trường | |
---|---|
announcements[] |
Các mục thông báo phù hợp với yêu cầu. |
nextPageToken |
Mã thông báo xác định trang kết quả tiếp theo cần trả về. Nếu trống, sẽ không có thêm kết quả nào. |
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.announcements
https://www.googleapis.com/auth/classroom.announcements.readonly
Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.