Quản lý bình luận và câu trả lời

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.

Lưu ý: Trên các tệp blob, API Google Drive chỉ hỗ trợ các nhận xét không liên kết. Không hỗ trợ nhận xét cố định trên tệp blob hoặc tệp Trình chỉnh sửa tài liệu của Google.

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ị.

Lưu ý quan trọng: Bạn nên kiểm tra để đảm bảo rằng người dùng có quyền phù hợp để thêm nhận xét. Ngoài ra, chỉ người tạo bình luận hoặc phản hồi mới có thể xoá hoặc chỉnh sửa bình luận hoặc phản hồi. Lỗi xảy ra khi người dùng không phải là nhà sáng tạo cố gắng xoá hoặc chỉnh sửa nhận xét. Để tránh những lỗi này, hãy kiểm tra trường author.me của tài nguyên nhận xét để đảm bảo người dùng đưa ra yêu cầu là tác giả của nhận xét, sau đó xác minh quyền của họ liên quan đến nhận xét.

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.

Lưu ý: Trên các tệp blob, API Drive chỉ hỗ trợ các nhận xét không liên kết. Hệ thống không hỗ trợ nhận xét cố định trên tệp blob hoặc tệp Trình chỉnh sửa tài liệu của Google.

Lưu ý quan trọng: Không thể thay đổi vị trí liên kết so với nội dung của tài liệu giữa các bản sửa đổi. Bạn nên sử dụng quảng cáo cố định cuối màn hình trong các tài liệu mà vị trí không thay đổi, chẳng hạn như tệp hình ảnh hoặc tài liệu chỉ có thể đọc.

Cách thêm một nhận xét liên kết:

1. (Tùy chọn). Gọi phương thức revisions.list để liệt kê mọi revisionID 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ụng head cho revisionID.

2. Gọi phương thức comments.create bằng tham số fileID, tài nguyên comments chứa nhận xét và chuỗi liên kết JSON chứa revisionID (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.

Lưu ý: Bạn nên kiểm tra để đảm bảo rằng người dùng có quyền phù hợp để thêm nhận xét. Ngoài ra, chỉ người tạo bình luận hoặc phản hồi mới có thể xoá hoặc chỉnh sửa bình luận hoặc phản hồi. Lỗi xảy ra khi một người không phải là nhà sáng tạo cố gắng xoá hoặc chỉnh sửa nhận xét. Để tránh những lỗi này, hãy xem trường author.me của tài nguyên nhận xét.

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ể.

Lưu ý quan trọng: Nếu ứng dụng của bạn cho phép người dùng cập nhật và chia sẻ nhiều bản sửa đổi của một tài liệu, thì nhận xét trên các bản sửa đổi cũ có thể không còn áp dụng cho vị trí cố định nữa. Do đó, bạn phải chỉ định rõ mỗi nhận xét thuộc bản sửa đổi nào trong giao diện người dùng.

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.