資源: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 |
用於建立這則註解的純文字內容。這並非 HTML 安全,只應做為編輯註解內容的起點。 |
context |
加註檔案的背景資訊。 |
context.type |
內容片段的 MIME 類型。 |
context.value |
註解檔案部分的資料。舉例來說,文字檔就是要加註的實際文字。 |
fileTitle |
僅供輸出。註解所處理檔案的標題。 |
方法 |
|
---|---|
|
刪除註解。 |
|
依 ID 取得註解。 |
|
在指定檔案上建立新註解。 |
|
列出檔案的註解。 |
|
更新現有的註解。 |
|
更新現有的註解。 |