REST Resource: comments

Tài nguyên: Nhận xét

Một nhận xét về tệp.

Một số phương thức tài nguyên (chẳng hạn như comments.update) yêu cầu commentId. Sử dụng phương thức comments.list để truy xuất mã nhận dạng cho một nhận xét trong tệp.

Biểu diễn dưới dạng JSON
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
Trường
id

string

Chỉ có đầu ra. Mã của nhận xét.

kind

string

Chỉ có đầu ra. Xác định loại tài nguyên này. Giá trị: chuỗi cố định "drive#comment".

createdTime

string

Chỉ có đầu ra. Thời gian tạo bình luận (ngày-giờ theo RFC 3339).

modifiedTime

string

Chỉ có đầu ra. Lần gần nhất bình luận hoặc bất kỳ phản hồi nào của bình luận đó được sửa đổi (ngày-giờ theo RFC 3339).

resolved

boolean

Chỉ có đầu ra. Liệu bình luận đó đã được giải quyết bằng một trong các câu trả lời hay chưa.

anchor

string

Một vùng của tài liệu được biểu thị dưới dạng chuỗi JSON. Để biết thông tin chi tiết về cách xác định thuộc tính neo, hãy tham khảo bài viết Quản lý bình luận và câu trả lời.

replies[]

object (Reply)

Chỉ có đầu ra. Danh sách đầy đủ các lượt trả lời bình luận theo thứ tự thời gian.

author

object (User)

Chỉ có đầu ra. Tác giả của bình luận. Địa chỉ email và mã quyền của tác giả sẽ không được điền.

deleted

boolean

Chỉ có đầu ra. Liệu nhận xét đã bị xoá hay chưa. Bình luận đã xoá không có nội dung.

htmlContent

string

Chỉ có đầu ra. Nội dung của nhận xét có định dạng HTML.

content

string

Nội dung bình luận ở dạng văn bản thuần tuý. Trường này dùng để thiết lập nội dung, trong khi htmlContent sẽ hiển thị.

quotedFileContent

object

Nội dung tệp mà nhận xét đề cập đến, thường nằm trong vùng neo. Ví dụ: đối với tệp văn bản, đây sẽ là văn bản tại vị trí của chú thích.

quotedFileContent.mimeType

string

Loại MIME của nội dung được trích dẫn.

quotedFileContent.value

string

Chính nội dung được trích dẫn. Giá trị này được diễn giải dưới dạng văn bản thuần tuý nếu được đặt thông qua API.

Phương thức

create

Tạo nhận xét trên tệp.

delete

Xoá một bình luận.

get

Lấy bình luận theo mã.

list

Liệt kê các nhận xét của tệp.

update

Cập nhật nhận xét bằng ngữ nghĩa của bản vá.