Method: courses.announcements.list

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 khoá học chỉ có thể xem thông báo về PUBLISHED. Giáo viên 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 vào khoá học được yêu cầu hoặc gặp phải 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

Tham số
courseId

string

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 alias.

Tham số truy vấn

Tham số
announcementStates[]

enum (AnnouncementState)

Hạn chế đối với state thông báo được trả về. Nếu bạn không chỉ định đối số này, giá trị mặc định sẽ là PUBLISHED.
orderBy

string

Thứ tự sắp xếp không bắt buộc cho kết quả. Danh sách các trường được phân tách bằng dấu phẩy có từ khoá không bắt buộc về hướng sắp xếp. Trường được hỗ trợ là updateTime. Các từ khoá chỉ đường được hỗ trợ là asc và desc. Nếu không được chỉ định, updateTime desc sẽ là chế độ mặc định. Ví dụ: updateTime asc, updateTime
pageSize

integer

Số mục tối đa cần trả về. Số không hoặc chưa được chỉ định cho biết máy chủ có thể chỉ định số tiền tối đa.

Máy chủ có thể trả về ít kết quả hơn số lượng kết quả đã chỉ định.
pageToken

string

Giá trị nextPageToken được trả về từ lệnh gọi list trước đó, cho biết cần trả về trang kết quả tiếp theo.

Nếu không, yêu cầu list phải giống với yêu cầu đã tạo ra mã thông báo này.

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 (Announcement)
    }
  ],
  "nextPageToken": string
}
Trường
announcements[]

object (Announcement)

Các mục thông báo phù hợp với yêu cầu.
nextPageToken

string

Mã thông báo xác định trang kết quả tiếp theo cần trả về. Nếu trống, 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.