資源:Comment
對檔案加註。
部分資源方法 (例如 comments.update
) 需要 commentId
。使用 comments.list
方法擷取檔案中的註解 ID。
JSON 表示法 |
---|
{ "id": string, "kind": string, "createdTime": string, "modifiedTime": string, "resolved": boolean, "anchor": string, "replies": [ { object ( |
欄位 | |
---|---|
id |
僅供輸出。留言的 ID。 |
kind |
僅供輸出。指出資源的類型。值:固定字串 |
createdTime |
僅供輸出。建立留言的時間 (RFC 3339 日期時間)。 |
modifiedTime |
僅供輸出。上次修改註解或其任何回覆的時間 (RFC 3339 日期時間)。 |
resolved |
僅供輸出。留言是否已根據相關的回覆解決。 |
anchor |
以 JSON 字串表示的文件區域。如要進一步瞭解如何定義錨定屬性,請參閱「管理註解和回覆」。 |
replies[] |
僅供輸出。按時間順序排列的留言完整回覆清單。 |
author |
僅供輸出。留言的作者。系統不會填入作者的電子郵件地址和權限 ID。 |
deleted |
僅供輸出。留言是否已遭刪除。刪除的留言沒有內容。 |
htmlContent |
僅供輸出。使用 HTML 格式設定註解的內容。 |
content |
留言的純文字內容。這個欄位用於設定內容,而應顯示 |
quotedFileContent |
註解參照的檔案內容,通常位於錨點區域內。以文字檔案為例,這是註解位置中的文字。 |
quotedFileContent.mimeType |
引用內容的 MIME 類型。 |
quotedFileContent.value |
引用內容本身。如果您是透過 API 設定,系統會將這個值解讀為純文字。 |
方法 |
|
---|---|
|
建立檔案註解。 |
|
刪除留言。 |
|
依 ID 取得留言。 |
|
列出檔案的註解。 |
|
更新含有修補程式語意的註解。 |