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 不是 RESOLVEREOPEN,则必须为非空值。

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

不得超过 2048 个 UTF-8 代码单元。

contentHtml

string

仅限输出。帖子的内容(采用 HTML 格式)。

author

object (PostAuthor)

仅限输出。创建帖子的用户。

createTime

string (Timestamp format)

仅限输出。帖子的创建时间。

updateTime

string (Timestamp format)

仅限输出。上次更新帖子时的时间。

deleted

boolean

仅限输出。帖子是否已删除。如果为 true,则 contentauthor 字段将为空。

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