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

 使用 patch 語意更新留言。