Nhận xét là phản hồi do người dùng cung cấp về một tệp, chẳng hạn như người đọc tài liệu xử lý từ đề xuất cách diễn đạt lại một câu. Có hai loại nhận xét: nhận xét cố định và nhận xét không neo. Một nhận xét cố định được liên kết với một vị trí cụ thể (chẳng hạn như một câu trong tài liệu xử lý từ) trong một phiên bản cụ thể của tài liệu đó. Ngược lại, một nhận xét không liên kết sẽ chỉ được liên kết với tài liệu.
Phản hồi được đính kèm vào bình luận và cho biết phản hồi của người dùng đối với bình luận đó. API Drive cho phép người dùng thêm nhận xét và câu trả lời vào các tài liệu do ứng dụng của bạn tạo. Nói chung, một nhận xét kèm theo câu trả lời được gọi là cuộc thảo luận.
Thêm nhận xét hủy neo
Để thêm một nhận xét chưa liên kết vào tài liệu, hãy gọi phương thức comments.create
với tham số fileId
và tài nguyên comments
chứa nhận xét đó.
Bình luận được chèn dưới dạng văn bản thuần tuý, nhưng nội dung phản hồi cung cấp một trường htmlContent
chứa nội dung được định dạng để hiển thị.
Thêm phản hồi cho nhận xét
Để thêm một phản hồi cho một bình luận, hãy gọi phương thức replies.create
kèm theo bình luận đó, tham số fileId
và tài nguyên replies
chứa phản hồi đó.
Câu trả lời được chèn ở dạng văn bản thuần tuý, nhưng nội dung phản hồi cung cấp một trường htmlContent
chứa nội dung được định dạng để hiển thị.
Thêm một nhận xét liên kết vào bản sửa đổi gần đây nhất của tài liệu
Khi thêm nhận xét, bạn nên liên kết nhận xét đó vào một vùng trong tệp. Neo xác định bản sửa đổi và vùng trong tệp mà nhận xét tham chiếu đến. Tài nguyên comments
định nghĩa trường anchor
ở dạng chuỗi JSON.
Cách thêm một nhận xét liên kết:
(Tùy chọn). Gọi phương thức
revisions.list
để liệt kê mọirevisionID
của một tài liệu. Bạn chỉ nên làm theo bước này nếu muốn liên kết một nhận xét với bất kỳ bản sửa đổi nào không phải là bản sửa đổi gần đây nhất. Nếu bạn muốn sử dụng bản sửa đổi mới nhất, hãy sử dụnghead
chorevisionID
.Gọi phương thức
comments.create
bằng tham sốfileID
, tài nguyêncomments
chứa nhận xét và chuỗi liên kết JSON chứarevisionID
(r
) và khu vực (a
).
Cách bạn xác định khu vực phụ thuộc vào loại nội dung tài liệu mà bạn đang xử lý. Để biết thêm thông tin, hãy tham khảo bài viết Xác định khu vực.
Xác định khu vực
Như đã đề cập trước đó, chuỗi liên kết JSON chứa một revisionID
(r
) và khu vực (a
). Khu vực (a
) là một mảng JSON chứa các thuật toán phân loại khu vực chỉ định định dạng và vị trí liên kết một nhận xét. Thuật toán phân loại có thể là hình chữ nhật hai chiều của một hình ảnh, một dòng văn bản trong tài liệu hoặc một khoảng thời gian trong video. Để xác định một khu vực, hãy chọn trình phân loại khu vực khớp với loại nội dung bạn đang cố gắng liên kết. Ví dụ: nếu nội dung của bạn là văn bản, bạn có thể sẽ sử dụng thuật toán phân loại khu vực txt
hoặc line
.
Để biết danh sách thuật toán phân loại khu vực trong API Drive, hãy tham khảo Trình phân loại khu vực.
Ví dụ sau đây cho thấy một chuỗi liên kết JSON liên kết các nhận xét vào các dòng trong hai khu vực riêng biệt của tài liệu:
- Vùng đầu tiên bắt đầu từ dòng 12 (
'n':12
) và mở rộng thành 3 dòng ('l':3
). - Khu vực thứ hai chỉ bao gồm dòng 18 (
'n':18, 'l':1
`).
{
'r': 'REVISION_ID',
'a': [
{
'line':
{
'n': 12,
'l': 3,
}
},
{
'line':
{
'n': 18,
'l': 1,
}
}]
}
Thay thế REVISION_ID bằng head
hoặc mã của một bản sửa đổi cụ thể.
Giải quyết nhận xét
Sử dụng phương thức comment.update
để đặt thuộc tính resolved
trong tài nguyên comments
thành true
khi đã giải quyết một nhận xét.
Khi ứng dụng của bạn đặt thuộc tính resolved
thành true
, giao diện người dùng của bạn sẽ cho biết nhận xét đã được xử lý. Ví dụ: ứng dụng của bạn có thể:
- Không cho phép thêm các câu trả lời và làm mờ tất cả các câu trả lời trước đó cùng với bình luận gốc.
- Ẩn nhận xét đã giải quyết.
Xóa nhận xét
Hãy dùng phương thức comments.delete
để xoá nhận xét. Khi một nhận xét bị xoá, Drive sẽ đánh dấu tài nguyên nhận xét là "deleted": "true"
.
Danh sách nhận xét
Sử dụng phương thức comments.list
để liệt kê nhận xét. Nếu bạn muốn đưa các nhận xét đã xoá vào kết quả, hãy đặt trường includedDeleted
thành true
.