REST Resource: comments

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

Nhận xét về một tệp trong Google Drive.

Một số phương thức tài nguyên (chẳng hạn như comments.update) yêu cầu commentId. 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
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
Trường
commentId

string

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

kind

string

Chỉ có đầu ra. Thao tác này luôn là drive#comment.

createdDate

string

Chỉ có đầu ra. Ngày tạo nhận xét này lần đầu tiên.

modifiedDate

string

Chỉ có đầu ra. Ngày sửa đổi gần đây nhất của bình luận này hoặc bất kỳ nội dung trả lời nào của bình luận.

fileId

string

Chỉ có đầu ra. Tệp mà nhận xét này đang xử lý.

status

string

Chỉ có đầu ra. Trạng thái của nhận xét này. Bạn có thể thay đổi trạng thái bằng cách đăng phản hồi cho một bình luận theo trạng thái mong muốn.

  • open – Nhận xét vẫn đang mở.
  • resolved - Nhận xét đã được giải quyết bằng một trong các phản hồi của nhận xét.
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 các thuộc tính neo, hãy tham khảo bài viết Thêm nhận xét và câu trả lời.

replies[]

object (CommentReply)

Chỉ có đầu ra. Các phản hồi cho bài đăng này.

author

object (User)

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

deleted

boolean

Chỉ có đầu ra. Liệu nhận xét này đã bị xóa hay chưa. Nếu một bình luận đã bị xoá, nội dung đó sẽ bị xoá và chỉ thể hiện một bình luận đã từng tồn tại.

htmlContent

string

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

content

string

Nội dung văn bản thuần tuý được dùng để tạo nhận xét này. Đây không phải là HTML an toàn và chỉ nên được sử dụng làm điểm bắt đầu để thực hiện các chỉnh sửa cho nội dung của nhận xét.

context

object

Ngữ cảnh của tệp đang được nhận xét.

context.type

string

Loại MIME của đoạn mã ngữ cảnh.

context.value

string

Biểu thị dữ liệu của phân đoạn đang được nhận xét trong tệp. Ví dụ như đối với một tệp văn bản, đây sẽ là văn bản thực tế được đề cập trong nhận xét.

fileTitle

string

Chỉ có đầu ra. Tiêu đề của tệp mà nhận xét này đang xử lý.

Phương thức

delete

Xoá bình luận.

get

Nhận nhận xét theo mã nhận dạng.

insert

Tạo nhận xét mới trên tệp đã cho.

list

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

patch

Cập nhật một nhận xét hiện có.

update

Cập nhật một nhận xét hiện có.