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

Nhận xét là ý kiến phản hồi do người dùng đưa ra về một tệp, chẳng hạn như người đọc tài liệu xử lý văn bản gợi ý 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 cố định. Một điểm neo nhận xét được liên kết với một vị trí cụ thể, chẳng hạn như một câu trong trong một phiên bản cụ thể của một tài liệu. Ngược lại, một nhận xét không neo 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ợ nhận xét không cố định. Không hỗ trợ nhận xét cố định trên các tệp blob hoặc tệp của Trình chỉnh sửa Google Tài liệu.

Phản hồi được đính kèm vào nhận xét và thể hiện phản hồi của người dùng đối với nhận xét. API Drive cho phép người dùng của bạn thêm nhận xét và câu trả lời tài liệu do ứng dụng của bạn tạo. Nói chung, một bình luận có phản hồi được gọi là cuộc thảo luận.

Thêm nhận xét không liên kết

Để thêm nhận xét không liên kết vào tài liệu, hãy gọi phương thức comments.create bằng tham số fileId và Tài nguyên comments chứa nhận xét.

Nhận xét đượ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 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 để chắc chắn 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 nhận xét hoặc câu trả lời mới có thể xóa hoặc chỉnh sửa nhận xét hoặc câu trả lời. Lỗi xảy ra khi người dùng (với vai trò không phải nhà sáng tạo) cố gắng xóa 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 và sau đó xác minh quyền liên quan đến bình luận đó.

Thêm phản hồi cho bình luận

Để thêm câu trả lời cho nhận xét, hãy gọi replies.create với nhận xét, tham số fileId và tài nguyên replies có chứa câu trả lời.

Câu trả lời đượ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 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 mới nhất của tài liệu

Khi thêm một nhận xét, có thể bạn muốn neo nhận xét đó vào một vùng trong tệp. Một anchor xác định bản sửa đổi và khu vực của tệp trong tệp mà nhận xét đề cập. Tài nguyên comments xác định Trường anchor dưới dạng chuỗi JSON.

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

Lưu ý quan trọng: Văn bản liên kết là không thể thay đổi và vị trí của chúng tương ứng với nội dung của không thể đảm bảo tài liệu giữa các lần sửa đổi. Bạn nên sử dụng quảng cáo cố đị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 chế độ chỉ có thể đọc tài liệu.

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

1. (Tùy chọn). Gọi revisions.list để liệt kê mỗi revisionID cho một tài liệu. Chỉ làm theo bước này nếu bạn muốn neo nhận xét vào bất kỳ bản sửa đổi nào khác ngoài bản sửa đổi mới nhất. Nếu bạn muốn sử dụng bản sửa đổi mới nhất, hãy dùng head cho revisionID.

2. Gọi phương thức comments.create với tham số fileID, comments tài nguyên chứa nhận xét và một chuỗi neo JSON có chứa revisionID (r) và khu vực (a).

Cách bạn xác định một khu vực phụ thuộc vào loại nội dung tài liệu mà bạn đang xử lý với. Để 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 để chắc chắn rằng người dùng có quyền thích hợp để thêm nhận xét. Ngoài ra, chỉ người tạo nhận xét hoặc câu trả lời mới có thể xóa hoặc chỉnh sửa nhận xét hoặc câu trả lời. Lỗi xảy ra khi một người (với vai trò không phải nhà sáng tạo) cố gắng xóa 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 bình luận.

Xác định khu vực

Như đã đề cập trước đó, chuỗi neo JSON chứa revisionID (r) và khu vực (a). Khu vực (a) là một mảng JSON chứa bộ phân loại khu vực chỉ định định dạng và vị trí mà nhận xét được liên kết. Một thuật toán phân loại có thể là hình chữ nhật hai chiều cho hình ảnh, một dòng văn bản trong tài liệu, hoặc thời lượng trong video. Để xác định một khu vực, hãy chọn khu vực thuật toán phân loại khớp với loại nội dung mà bạn đang cố gắng neo vào. Cho ví dụ: nếu nội dung của bạn là văn bản, bạn có thể sử dụng txt hoặc thuật toán phân loại khu vực line.

Để xem danh sách thuật toán phân loại khu vực trong API Drive, hãy tham khảo Khu vực thuật toán phân loại.

Ví dụ sau đây cho thấy một chuỗi neo JSON giúp neo nhận xét vào các dòng trong hai phần riêng biệt của tài liệu:

• Khu vực đầu tiên bắt đầu từ dòng 12 ('n':12) và kéo dài thêm 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ã nhận dạng của một mã cụ thể bản sửa đổi này.

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, nhận xét trên các bản sửa đổi cũ hơn có thể không còn áp dụng cho vùng cố định cuối màn hình vị trí. Do đó, bạn phải cho biết mỗi nhận xét thuộc về bản sửa đổi nào rõ ràng 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 comments tài nguyên vào true khi nhận xét đã được xử lý.

Khi ứng dụng của bạn đặt thuộc tính resolved thành true, giao diện người dùng phải cho biết cho biết nhận xét đó đã được xử lý. Ví dụ như ứng dụng của bạn có thể:

• Không cho phép trả lời thêm và làm mờ tất cả các câu trả lời trước đó và nội dung gốc nhận xét.
• Ẩn các nhận xét đã giải quyết.

Xóa nhận xét

Sử 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 dưới dạng "deleted": "true".

Nhận xét danh sách

Sử dụng phương thức comments.list để liệt kê nhận xét. Nếu bạn muốn bao gồm nhận xét đã xóa trong kết quả, hãy đặt Trường includedDeleted đến true.