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.
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:
gradingPeriodsapplyToExistingCoursework Đâ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.
Trừ phi có lưu ý khác, nội dung của trang này được cấp phép theo Giấy phép ghi nhận tác giả 4.0 của Creative Commons và các mẫu mã lập trình được cấp phép theo Giấy phép Apache 2.0. Để biết thông tin chi tiết, vui lòng tham khảo Chính sách trang web của Google Developers. Java là nhãn hiệu đã đăng ký của Oracle và/hoặc các đơn vị liên kết với Oracle.
Cập nhật lần gần đây nhất: 2025-02-27 UTC.
[null,null,["Cập nhật lần gần đây nhất: 2025-02-27 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."]]],[]]
