Method: courses.topics.patch

Cập nhật một hoặc nhiều trường của một chủ đề.

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

  • PERMISSION_DENIED nếu dự án nhà phát triển yêu cầu không tạo chủ đề tương ứng hoặc đố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 hoặc chủ đề được yêu cầu không tồn tại

Yêu cầu HTTP

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

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

Tham số đường dẫn

Tham số
courseId

string

Giá trị nhận dạng của khoá học. Giá trị nhận dạng này có thể là giá trị nhận dạng do Lớp học chỉ định hoặc alias.
id

string

Giá trị nhận dạng của chủ đề.

Tham số truy vấn

Tham số
updateMask

string (FieldMask format)

Mặt nạ xác định những trường trên chủ đề cần cập nhật. Đây là trường bắt buộc để cập nhật. Quá trình cập nhật sẽ không thành công nếu bạn chỉ định các trường không hợp lệ. Nếu một trường hỗ trợ giá trị trống, bạn có thể xoá trường đó bằng cách chỉ định trường đó trong mặt nạ cập nhật chứ không phải trong đối tượng Chủ đề. Nếu một trường không hỗ trợ giá trị trống nằm trong mặt nạ cập nhật và không được đặt trong đối tượng Chủ đề, thì lỗi INVALID_ARGUMENT sẽ được trả về.

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

  • name

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

Nội dung yêu cầu

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

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

Phạm vi uỷ quyền

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

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

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