Method: courses.checkGradingPeriodsSetupEligibility

Trả về việc người dùng có đủ điều kiện cập nhật Chấm điểm Cài đặt trong một khoá học nhất định hay không.

Phương thức này không còn được dùng nữa. Thay vào đó, hãy sử dụng UserProfiles.checkUserCapability.

Phương thức này trả về các mã lỗi sau:

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

Yêu cầu HTTP

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

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
courseId

string

Bắt buộc. Giá trị nhận dạng của khoá học.

Tham số truy vấn

Thông số
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

Liệu người dùng có được phép cập nhật GradingPeriodSettings trong khoá học này hay không.

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 
{
  "courseId": string,
  "isGradingPeriodsSetupEligible": boolean,
  "previewVersion": enum (PreviewVersion)
}
Trường
courseId

string

Không thể thay đổi. Giá trị nhận dạng của khoá học.
isGradingPeriodsSetupEligible

boolean

Liệu người dùng có được phép cập nhật GradingPeriodSettings trong khoá học này hay không.
previewVersion

enum (PreviewVersion)

Chỉ có đầu ra. Phiên bản xem trước của API. Bạn phải đặt thuộc tính này để truy cập vào các chức năng API mới được cung cấp cho nhà phát triển trong Chương trình dùng thử.

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

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