CommentThread

表示演示文稿中的单个评论串。

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

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "plainTextQuote": string
  // End of mutually exclusive fields.
}
字段
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,则必须为非空值。

此文本内容的处理方式与在幻灯片编辑器中创建的评论类似。它在格式设置、通知等方面具有类似的行为。

不得超过 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 错误请求错误:

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 评论串已解决。