REST Resource: comments

資源：註解

已對檔案加上註解。

部分資源方法 (例如 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

 使用修補語意更新註解。