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ố địnhnhậ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.

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

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.

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.

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.

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.