REST Resource: comments

Tài nguyên: Bình luận

Một bình luận 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 có commentId. Sử dụng phương thức comments.list để truy xuất mã nhận dạng của một bình luận trong tệp.

Biểu diễn dưới dạng JSON 
{
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "status": string,
  "anchor": string,
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  },
  "fileTitle": string
}
Trường
replies[]

object (CommentReply)

Chỉ có đầu ra. Các câu trả lời cho bài đăng này.
commentId

string

Chỉ có đầu ra. Mã nhận dạng của bình luận.
kind

string

Chỉ có đầu ra. Trạng thái này luôn là drive#comment.
createdDate

string

Chỉ có đầu ra. Ngày tạo bình luận này lần đầu tiên.
modifiedDate

string

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

string

Chỉ có đầu ra. Tệp mà bình luận này đề cập đến.
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 câu trả lời cho một 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 này.
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 của điểm neo, hãy tham khảo phần Thêm bình luận và phản hồi.
author

object (User)

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

boolean

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

string

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

string

Nội dung văn bản thuần tuý được dùng để tạo bình luận này. Đây không phải là HTML an toàn và chỉ nên được dùng làm điểm bắt đầu để chỉnh sửa nội dung của một 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 ngữ cảnh.
context.value

string

Dữ liệu biểu thị đoạn của 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à bình luận đề cập đến.
fileTitle

string

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

Phương thức

delete

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

get

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

insert

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

list

 Liệt kê các bình luận của một tệp.

patch

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

update

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