REST Resource: comments

資源：Comment

Google 雲端硬碟檔案的註解。

JSON 表示法 
{
  "commentId": string,
  "kind": string,
  "createdDate": string,
  "modifiedDate": string,
  "fileId": string,
  "fileTitle": string,
  "status": string,
  "anchor": string,
  "replies": [
    {
      object (CommentReply)
    }
  ],
  "author": {
    object (User)
  },
  "deleted": boolean,
  "selfLink": string,
  "htmlContent": string,
  "content": string,
  "context": {
    "type": string,
    "value": string
  }
}
欄位
commentId

string

留言的 ID。
kind

string

這項值一律為 drive#comment。
createdDate

string

首次建立這則留言的日期。
modifiedDate

string

這個留言或任何回覆上次修改的日期。
fileId

string

註解所指的檔案。
fileTitle

string

註解所指檔案的標題。
status

string

這則留言的狀態。如要變更狀態，請回覆留言並附上所需狀態。可能的值為：

  • open - 註解仍處於開啟狀態。
  • resolved - 留言已透過其中一則回覆解決。
anchor

string

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

object (CommentReply)

回覆這則貼文。
author

object (User)

撰寫這則留言的使用者。
deleted

boolean

是否已刪除這則留言。如果留言已遭刪除，系統會清除內容，只會顯示這則留言曾經存在。
htmlContent

string

這則留言的 HTML 格式內容。
content

string

用於建立這則留言的純文字內容。這並非 HTML 安全，僅做為編輯留言內容的起點。
context

object

要加註的檔案內容。
context.type

string

情境程式碼片段的 MIME 類型。
context.value

string

檔案中加上註解的片段所代表的資料。舉例來說，如果是文字檔，這就是留言所指的實際文字。

方法

delete

 刪除留言。

get

 依 ID 取得留言。

insert

 在指定檔案中建立新留言。

list

 列出檔案的註解。

patch

 更新現有註解。

update

 更新現有註解。