REST Resource: comments

資源：Comment

對檔案加註。

部分資源方法 (例如 comments.update) 需要 commentId。使用 comments.list 方法擷取檔案中的註解 ID。

JSON 表示法 
{
  "id": string,
  "kind": string,
  "createdTime": string,
  "modifiedTime": string,
  "resolved": boolean,
  "anchor": string,
  "replies": [
    {
      object (Reply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "htmlContent": string,
  "content": string,
  "quotedFileContent": {
    "mimeType": string,
    "value": string
  }
}
欄位
id

string

僅供輸出。留言的 ID。
kind

string

僅供輸出。指出資源的類型。值：固定字串 "drive#comment"。
createdTime

string

僅供輸出。建立留言的時間 (RFC 3339 日期時間)。
modifiedTime

string

僅供輸出。上次修改註解或其任何回覆的時間 (RFC 3339 日期時間)。
resolved

boolean

僅供輸出。留言是否已根據相關的回覆解決。
anchor

string

以 JSON 字串表示的文件區域。如要進一步瞭解如何定義錨定屬性，請參閱「管理註解和回覆」。
replies[]

object (Reply)

僅供輸出。按時間順序排列的留言完整回覆清單。
author

object (User)

僅供輸出。留言的作者。系統不會填入作者的電子郵件地址和權限 ID。
deleted

boolean

僅供輸出。留言是否已遭刪除。刪除的留言沒有內容。
htmlContent

string

僅供輸出。使用 HTML 格式設定註解的內容。
content

string

留言的純文字內容。這個欄位用於設定內容，而應顯示 htmlContent。
quotedFileContent

object

註解參照的檔案內容，通常位於錨點區域內。以文字檔案為例，這是註解位置中的文字。
quotedFileContent.mimeType

string

引用內容的 MIME 類型。
quotedFileContent.value

string

引用內容本身。如果您是透過 API 設定，系統會將這個值解讀為純文字。

方法

create

 建立檔案註解。

delete

 刪除留言。

get

 依 ID 取得留言。

list

 列出檔案的註解。

update

 更新含有修補程式語意的註解。