Method: courses.studentGroups.patch

Cập nhật một hoặc nhiều trường trong một nhóm học viên.

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 nhóm sinh viên được yêu cầu hoặc đối với lỗi truy cập.
  • NOT_FOUND nếu nhóm học viên không tồn tại hoặc người dùng không có quyền truy cập vào nhóm học viên.
  • INVALID_ARGUMENT nếu bạn chỉ định các trường không hợp lệ trong mặt nạ cập nhật hoặc nếu bạn không cung cấp mặt nạ cập nhật.

Yêu cầu HTTP

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

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

string

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

Tham số truy vấn

Thông số
updateMask

string (FieldMask format)

Bắt buộc. Mặt nạ xác định những trường cần cập nhật trong nhóm học viên. Bạn phải điền thông tin vào trường này để cập nhật. Quá trình cập nhật sẽ thất bại nếu bạn chỉ định các trường không hợp lệ.

Giáo viên có thể chỉ định các trường sau:

  • title

Đâ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"
previewVersion

enum (PreviewVersion)

Không bắt buộc. Phiên bản xem trước của điểm cuối. Bạn phải đặt giá trị 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 StudentGroup.

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

Phạm vi uỷ quyền

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

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

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