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. 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 
{
  "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. Giá trị này luôn là drive#comment.
createdDate

string

Chỉ có đầu ra. Ngày tạo nhận xét này.
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ỳ phản hồi nào của bình luận này.
fileId

string

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

string

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

  • open – Nhận xét vẫn đang mở.
  • resolved – Một trong các câu trả lời đã giải quyết bình luận đó.
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 phần Thêm nhận xét và phản hồi.
replies[]

object (CommentReply)

Chỉ có đầu ra. Nội dung trả lời bài đăng này.
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 này đã bị xoá hay chưa. Nếu một bình luận đã bị xoá, nội dung của bình luận đó sẽ bị xoá và chỉ thể hiện rằng từng có một bình luận.
htmlContent

string

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

string

Nội dung văn bản thuần tuý 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 dùng làm điểm xuất phát để chỉnh sửa nội dung của bình luận.
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

Dữ liệu trình bày phân đoạn của tệp đang được chú thích. Ví dụ: trong trường hợp tệp văn bản, đây sẽ là văn bản thực tế mà nhận xét đề cập đến.
fileTitle

string

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

Phương thức

delete

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

get

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

insert

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

list

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

patch

 Cập nhật bình luận hiện có.

update

 Cập nhật bình luận hiện có.