Method: courses.updateGradingPeriodSettings

Cập nhật chế độ cài đặt giai đoạn chấm điểm của một khoá học.

Người dùng và chủ sở hữu khoá học đưa ra yêu cầu phải đủ điều kiện để sửa đổi Giai đoạn chấm điểm. Để biết thông tin chi tiết, hãy xem yêu cầu về việc cấp phép.

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 sửa đổi các chế độ cài đặt giai đoạn chấm điểm trong một khoá học hoặc gặp lỗi truy cập:
    • UserIneligibleToUpdateGradingPeriodSettings
  • 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

PATCH https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings

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

Tham số đường dẫn

Tham số
courseId

string

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

Tham số truy vấn

Tham số
updateMask

string (FieldMask format)

Mặt nạ xác định những trường cần cập nhật trong GradingPeriodSettings.

Danh sách gradingPeriods GradeingPeriodSettings sẽ được thay thế hoàn toàn bằng các giai đoạn chấm điểm được chỉ định trong yêu cầu cập nhật. Ví dụ:

  • Giai đoạn chấm điểm có trong danh sách mà không có mã nhận dạng được coi là bổ sung và một mã nhận dạng mới sẽ được chỉ định khi bạn gửi yêu cầu.
  • Các giai đoạn chấm điểm hiện đang tồn tại nhưng bị thiếu trong yêu cầu sẽ bị coi là lượt xoá.
  • Giai đoạn chấm điểm bằng mã nhận dạng hiện có và dữ liệu đã sửa đổi được coi là nội dung chỉnh sửa. Dữ liệu chưa sửa đổi sẽ được giữ nguyên.
  • Giai đoạn chấm điểm đi kèm với mã nhận dạng không xác định sẽ dẫn đến lỗi.

Bạn có thể chỉ định các trường sau:

  • gradingPeriods
  • applyToExistingCoursework

Đây là danh sách các tên trường đủ điều kiện được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"

previewVersion

enum (PreviewVersion)

Không bắt buộc. 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ử.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của GradingPeriodSettings.

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

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/classroom.courses

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