資源: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 ( |
欄位 | |
---|---|
commentId |
僅供輸出。留言的 ID。 |
kind |
僅供輸出。一律為 |
createdDate |
僅供輸出。首次建立這則留言的日期。 |
modifiedDate |
僅供輸出。這則留言或其回覆中任一回覆的上次修改日期。 |
fileId |
僅供輸出。要提及這個註解的檔案。 |
status |
僅供輸出。此註解的狀態。如要變更狀態,請回覆留言並達到所需狀態。
|
anchor |
以 JSON 字串表示的文件區域。如要進一步瞭解如何定義錨定屬性,請參閱「新增註解和回覆」。 |
replies[] |
僅供輸出。回覆這則貼文。 |
author |
僅供輸出。留言的作者。系統不會填入作者的電子郵件地址和權限 ID。 |
deleted |
僅供輸出。表示這則留言是否已遭刪除。如果留言已遭刪除,系統會清除內容,而這只會代表已有的留言。 |
selfLink |
僅供輸出。返回這則留言的連結。 |
htmlContent |
僅供輸出。此註解的 HTML 格式內容。 |
content |
用來建立這則留言的純文字內容。這並不安全,建議您一開始先編輯註解內容。 |
context |
要加註的檔案結構定義。 |
context.type |
內容程式碼片段的 MIME 類型。 |
context.value |
指出使用者加註的檔案區段資料。以文字檔案為例,這會是註解的實際文字。 |
fileTitle |
僅供輸出。提及這則註解的檔案標題。 |
方法 |
|
---|---|
|
刪除留言。 |
|
依 ID 取得留言。 |
|
在指定檔案上建立新註解。 |
|
列出檔案的註解。 |
|
更新現有的留言。 |
|
更新現有的留言。 |