CommentThread

代表簡報中的單一註解討論串。

JSON 表示法 
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
欄位
commentId

string

留言串的專屬 ID。
anchorId

string

這個討論串所連結的簡報中 CommentAnchor 的 ID。
headPost

object (Post)

討論串中的第一則貼文。
replies[]

object (Post)

回覆主貼文。
status

enum (Status)

討論串是否已開啟或解決。
建立留言時，網頁元素中引用的文字。以下列出互斥欄位。回應中最多會設定一個欄位：
plainTextQuote

string

建立註解時，網頁元素中引用的文字 (格式為純文字)。
互斥欄位的結尾。

貼文

代表留言串中的單一留言。

JSON 表示法 
{
  "postId": string,
  "content": string,
  "contentHtml": string,
  "author": {
    object (PostAuthor)
  },
  "createTime": string,
  "updateTime": string,
  "deleted": boolean,
  "fromImportedPresentation": boolean,
  "fromCopiedPresentation": boolean,
  "assigneeEmail": string,
  "commentAction": enum (CommentActionType)
}
欄位
postId

string

僅供輸出。貼文的專屬 ID。
content

string

貼文內容。

如果 commentAction 不是 RESOLVE 或 REOPEN，則不得為空白。

這類文字內容的處理方式，與在 Google 簡報編輯器中建立的註解類似。格式設定、通知等行為與舊版類似。

不得超過 2048 個 UTF-8 程式碼單元。
contentHtml

string

僅供輸出。以 HTML 格式呈現的貼文內容。
author

object (PostAuthor)

僅供輸出。發布貼文的使用者。
createTime

string (Timestamp format)

僅供輸出。貼文的建立時間。
updateTime

string (Timestamp format)

僅供輸出。貼文的上次更新時間。
deleted

boolean

僅供輸出。貼文是否已刪除。如果 true、content 和 author 欄位會留空。
fromImportedPresentation

boolean

僅供輸出。貼文是否來自匯入的簡報。來電者無法直接設定這個欄位。
fromCopiedPresentation

boolean

僅供輸出。貼文是否來自複製的簡報。來電者無法直接設定這個欄位。
assigneeEmail

string

(選用步驟) 這則貼文新指派給討論串的使用者電子郵件地址。

如果發生下列情況，系統會傳回 400 Bad Request 錯誤：
commentAction

enum (CommentActionType)

建立貼文時採取的動作。

PostAuthor

代表撰寫留言貼文的使用者。

JSON 表示法 
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
欄位
displayName

string

使用者的顯示名稱。如果作者匿名，則可能不會顯示。
me

boolean

使用者是否為提出要求的已驗證使用者。
anonymous

boolean

使用者是否匿名。
user

string

貼文作者的使用者資源名稱，也可以用來在 Google People API 中識別使用者。格式：users/{user}。如果匿名欄位為 true，或是貼文來自匯入的簡報，系統就不會填入這項資訊。

CommentActionType

對留言討論串回覆所採取的動作。

列舉
COMMENT_ACTION_TYPE_UNSPECIFIED 預設值。這個值不會使用。
NO_COMMENT_ACTION_CHANGE 這則貼文沒有任何動作變更。
RESOLVE 這則貼文會解決該討論串的問題。
REOPEN 這則貼文會重新開啟討論串。

狀態

留言串的狀態選項。

列舉
STATUS_UNSPECIFIED 預設值。這個值不會使用。
OPEN 註解討論串已開啟。
RESOLVED 註解討論串已解決。