Method: courses.announcements.patch

Cập nhật một hoặc nhiều trường của một thông báo.

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 thông báo tương ứng hoặc do lỗi truy cập.
  • INVALID_ARGUMENT nếu yêu cầu không đúng định dạng.
  • Giá trị là FAILED_PRECONDITION nếu thông báo được yêu cầu đã bị xoá.
  • NOT_FOUND nếu không có khoá học hoặc thông báo được yêu cầu

Yêu cầu HTTP

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

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

Tham số đường dẫn

Các 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

Mã nhận dạng của thông báo.

Tham số truy vấn

Các tham số
updateMask

string (FieldMask format)

Mặt nạ giúp xác định những trường cần cập nhật trên thông báo. Đâ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ợ các giá trị trống, thì 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 Thông báo. Nếu một trường không hỗ trợ các giá trị trống được đưa vào mặt nạ cập nhật và không được đặt trong đối tượng Thông báo, thì hệ thống sẽ trả về lỗi INVALID_ARGUMENT.

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

  • text
  • state
  • scheduledTime

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

Nội dung yêu cầu

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

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

Phạm vi uỷ quyền

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

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

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