Method: courses.courseWork.list

Trả về danh sách bài tập trong khoá học mà người yêu cầu được phép xem.

Học viên của khoá học chỉ có thể xem bài tập PUBLISHED trong khoá học. Giáo viên khoá học và quản trị viên miền có thể xem tất cả bài tập trong khoá học.

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 đã 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 được yêu cầu không tồn tại.

Yêu cầu HTTP

GET https://classroom.googleapis.com/v1/courses/{courseId}/courseWork

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ố
courseWorkStates[]

enum (CourseWorkState)

Hạn chế về trạng thái công việc cần trả về. Chỉ trả về courseWork khớp. Nếu không chỉ định, hệ thống sẽ trả về các mục có trạng thái công việc là PUBLISHED.
orderBy

string

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

integer

Số lượng mục tối đa cần trả về. 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 hơn số kết quả được chỉ định.
pageToken

string

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

Yêu cầu list phải giống hệt với yêu cầu đã tạo ra mã thông báo này.
previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của API. Bạn phải đặt giá trị này để truy cập vào các tính năng API mới được cung cấp cho nhà phát triển trong Chương trình xem trước.

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ội dung phản hồi khi bạn đăng bài tập trong 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 
{
  "courseWork": [
    {
      object (CourseWork)
    }
  ],
  "nextPageToken": string
}
Trường
courseWork[]

object (CourseWork)

Các mục bài tập trong khoá học khớ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, bạn sẽ không nhận được kết quả nào khác.

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.coursework.students.readonly
  • https://www.googleapis.com/auth/classroom.coursework.me.readonly
  • https://www.googleapis.com/auth/classroom.coursework.students
  • https://www.googleapis.com/auth/classroom.coursework.me

Để biết thêm thông tin, hãy xem Hướng dẫn uỷ quyền.