Hiện tại, các nhà phát triển đã có thể sử dụng rộng rãi tiện ích bổ sung của Google Lớp học! Vui lòng xem tài liệu về tiện ích bổ sung để biết thêm thông tin.
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 gửi yêu cầu và chủ sở hữu khoá học phải đủ điều kiện để sửa đổi Kỳ chấm điểm. Để biết thông tin chi tiết, hãy xem các 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 chế độ cài đặt giai đoạn chấm điểm trong một khoá học hoặc do 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 được yêu cầu không tồn tại.
Mặt nạ xác định những trường trong GradingPeriodSettings cần cập nhật.
Danh sách GradingPeriodSettings gradingPeriods sẽ được thay thế hoàn toàn bằng các khoảng thời gian chấm điểm được chỉ định trong yêu cầu cập nhật. Ví dụ:
Các kỳ chấm điểm có trong danh sách nhưng không có mã sẽ được coi là nội dung bổ sung và mã 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 có nhưng bị thiếu trong yêu cầu sẽ được coi là bị xoá.
Các giai đoạn chấm điểm có 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.
Các giai đoạn chấm điểm có 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 tên đủ điều kiện của các trường được phân tách bằng dấu phẩy. Ví dụ: "user.displayName,photo"
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.
[[["Dễ hiểu","easyToUnderstand","thumb-up"],["Giúp tôi giải quyết được vấn đề","solvedMyProblem","thumb-up"],["Khác","otherUp","thumb-up"]],[["Thiếu thông tin tôi cần","missingTheInformationINeed","thumb-down"],["Quá phức tạp/quá nhiều bước","tooComplicatedTooManySteps","thumb-down"],["Đã lỗi thời","outOfDate","thumb-down"],["Vấn đề về bản dịch","translationIssue","thumb-down"],["Vấn đề về mẫu/mã","samplesCodeIssue","thumb-down"],["Khác","otherDown","thumb-down"]],["Cập nhật lần gần đây nhất: 2024-12-05 UTC."],[[["Updates a course's grading period settings, requiring eligibility to modify them by both the requesting user and course owner."],["The request must include a field mask to specify which fields of the GradingPeriodSettings are to be updated, potentially adding, deleting, or editing grading periods."],["The API uses a PATCH request to `https://classroom.googleapis.com/v1/courses/{courseId}/gradingPeriodSettings`, where `{courseId}` is replaced with the specific course identifier."],["Potential errors include `PERMISSION_DENIED`, `INVALID_ARGUMENT`, and `NOT_FOUND` based on user permissions, request validity, and course existence."],["Authorization requires the `https://www.googleapis.com/auth/classroom.courses` OAuth scope."]]],[]]
