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

Уникальный идентификатор ветки комментариев.

anchorId

string

Идентификатор элемента CommentAnchor в презентации, к которому привязана эта ветка обсуждения.

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

Только вывод. Уникальный идентификатор записи.

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 "Неверный запрос", если:

  • Родительская ветка — это ветка CommentThread , у headPost которой (headPost) нет назначенного исполнителя.

  • В параметре commentAction указано значение RESOLVE или REOPEN .

  • assigneeEmail превышает 2048 кодовых единиц UTF-8.

commentAction

enum ( CommentActionType )

Действия, предпринятые в рамках создания публикации.

Автор поста

Представляет пользователя, оставившего комментарий.

JSON-представление
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Поля
displayName

string

Отображаемое имя пользователя. Может отсутствовать, если автор анонимен.

me

boolean

Указывает, является ли пользователь авторизованным пользователем, отправляющим запрос.

anonymous

boolean

Является ли пользователь анонимным.

user

string

Имя ресурса пользователя-автора публикации, которое также может использоваться для идентификации пользователя в Google People API . Формат: users/{user} . Не будет заполнено, если поле anonymous имеет true или если публикация импортирована из презентации.

CommentActionType

Действие, предпринятое при ответе на этот комментарий.

Перечисления
COMMENT_ACTION_TYPE_UNSPECIFIED Значение по умолчанию. Это значение не используется.
NO_COMMENT_ACTION_CHANGE В этом посте никаких изменений в действиях не предусмотрено.
RESOLVE Этот пост разрешает спор.
REOPEN Этот пост возобновляет обсуждение.

Статус

Варианты статуса ветки комментариев.

Перечисления
STATUS_UNSPECIFIED Значение по умолчанию. Это значение не используется.
OPEN Обсуждение в комментариях открыто.
RESOLVED Обсуждение в комментариях завершено.