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
}
Các 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 lần đầu tiên.
modifiedDate

string

Chỉ có đầu ra. Ngày sửa đổi gần đây nhất nhận xét này hoặc bất kỳ câu trả lời nào.
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 bình luận có trạng thái mong muốn.

  • open – Nhận xét vẫn 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 khu vực 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ề việc xác định thuộc tính liên kết, hãy tham khảo Thêm nhận xét và phản hồi.
replies[]

object (CommentReply)

Chỉ có đầu ra. Trả lời 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.
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 các bình luận đó sẽ bị xoá và chỉ còn đại diện cho một bình luận trước đây.
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. Tệp này không an toàn cho HTML và chỉ nên dùng làm điểm bắt đầu khi chỉnh sửa 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

Bản biểu diễn dữ liệu của phân đoạn tệp đang được nhận xét. 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 đang đề cập.

Phương thức

delete

 Xoá nhận xét.

get

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

insert

 Tạo nhận xét mới về tệp cho sẵn.

list

 Liệt kê các nhận xét của 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ó.