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

 使用修補程式語意更新註解