REST Resource: comments

資源：Comment

為 Google 雲端硬碟中的檔案加註。

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

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

string

僅供輸出。留言的 ID。
kind

string

僅供輸出。一律為 drive#comment。
createdDate

string

僅供輸出。首次建立這則留言的日期。
modifiedDate

string

僅供輸出。這則留言或其回覆中任一回覆的上次修改日期。
fileId

string

僅供輸出。要提及這個註解的檔案。
status

string

僅供輸出。此註解的狀態。如要變更狀態，請回覆留言並達到所需狀態。

  • open - 註解仍在開啟中。
  • resolved - 其中一則回覆已解決該註解。
anchor

string

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

object (CommentReply)

僅供輸出。回覆這則貼文。
author

object (User)

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

boolean

僅供輸出。表示這則留言是否已遭刪除。如果留言已遭刪除，系統會清除內容，而這只會代表已有的留言。
htmlContent

string

僅供輸出。此註解的 HTML 格式內容。
content

string

用來建立這則留言的純文字內容。這並不安全，建議您一開始先編輯註解內容。
context

object

要加註的檔案結構定義。
context.type

string

內容程式碼片段的 MIME 類型。
context.value

string

指出使用者加註的檔案區段資料。以文字檔案為例，這會是註解的實際文字。
fileTitle

string

僅供輸出。提及這則註解的檔案標題。

方法

delete

 刪除留言。

get

 依 ID 取得留言。

insert

 在指定檔案上建立新註解。

list

 列出檔案的註解。

patch

 更新現有的留言。

update

 更新現有的留言。