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

用於建立這則註解的純文字內容。這並非 HTML 安全,只應做為編輯註解內容的起點。

context

object

加註檔案的背景資訊。

context.type

string

內容片段的 MIME 類型。

context.value

string

註解檔案部分的資料。舉例來說,文字檔就是要加註的實際文字。

fileTitle

string

僅供輸出。註解所處理檔案的標題。

方法

delete

刪除註解。

get

依 ID 取得註解。

insert

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

list

列出檔案的註解。

patch

更新現有的註解。

update

更新現有的註解。