CommentThread

Representa un solo hilo de comentarios dentro de una presentación.

Representación JSON
{
  "commentId": string,
  "anchorId": string,
  "headPost": {
    object (Post)
  },
  "replies": [
    {
      object (Post)
    }
  ],
  "status": enum (Status),

  "plainTextQuote": string
}
Campos
commentId

string

Es el ID único del subproceso de comentarios.

anchorId

string

ID del CommentAnchor en la presentación al que está vinculado este subproceso.

headPost

object (Post)

Es la primera publicación del hilo.

replies[]

object (Post)

Son las respuestas a la publicación principal.

status

enum (Status)

Indica si el hilo está abierto o resuelto.

Es el texto citado del elemento de página cuando se creó el comentario. La siguiente es una lista de campos mutuamente excluyentes. Como máximo, se establecerá uno de los campos en una respuesta:
plainTextQuote

string

Es el texto citado del elemento de página cuando se creó el comentario, con formato de texto sin formato.

Fin de los campos mutuamente excluyentes.

Publicar

Representa una sola publicación en un hilo de comentarios.

Representación 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)
}
Campos
postId

string

Solo salida. Es el ID único de la publicación.

content

string

Es el contenido de la publicación.

Debe no estar vacío si commentAction no es RESOLVE ni REOPEN.

Este contenido de texto se manejará de manera similar a los comentarios creados en el editor de Presentaciones. Tendrá comportamientos similares para el formato, las notificaciones, etcétera.

No puede superar las 2,048 unidades de código UTF-8.

contentHtml

string

Solo salida. Contenido de la publicación en formato HTML.

author

object (PostAuthor)

Solo salida. Es el usuario que creó la publicación.

createTime

string (Timestamp format)

Solo salida. Fecha y hora en que se creó la publicación.

updateTime

string (Timestamp format)

Solo salida. Fecha y hora en la que se actualizó la publicación por última vez.

deleted

boolean

Solo salida. Indica si se borró la publicación. Los campos true, content y author estarán vacíos.

fromImportedPresentation

boolean

Solo salida. Indica si la publicación proviene de una presentación importada. Las entidades que llaman no pueden establecer este campo directamente.

fromCopiedPresentation

boolean

Solo salida. Indica si la publicación proviene de una presentación copiada. Las entidades que llaman no pueden establecer este campo directamente.

assigneeEmail

string

Opcional. Es el correo electrónico del usuario al que se le asigna el hilo como parte de esta publicación.

Devuelve un error 400 de solicitud incorrecta en los siguientes casos:

  • El subproceso principal es un CommentThread cuyo headPost no tiene un asignatario.

  • commentAction se especifica como RESOLVE o REOPEN.

  • assigneeEmail supera las 2,048 unidades de código UTF-8.

commentAction

enum (CommentActionType)

Es la acción que se realizó como parte de la creación de la publicación.

PostAuthor

Representa a un usuario que escribió una publicación de comentario.

Representación JSON
{
  "displayName": string,
  "me": boolean,
  "anonymous": boolean,
  "user": string
}
Campos
displayName

string

Es el nombre visible del usuario. Puede no estar presente si el autor es anónimo.

me

boolean

Indica si el usuario es el usuario autenticado que realiza la solicitud.

anonymous

boolean

Indica si el usuario es anónimo.

user

string

Es el nombre del recurso del usuario autor de la publicación, que también se puede usar para identificar al usuario en la API de Google People. Formato: users/{user}. No se propagará si el campo anónimo es true o si la publicación proviene de una presentación importada.

CommentActionType

Es la acción que se realizó con esta respuesta a un hilo de comentarios.

Enums
COMMENT_ACTION_TYPE_UNSPECIFIED Valor predeterminado Este valor no se usa.
NO_COMMENT_ACTION_CHANGE En esta publicación, no se informa ningún cambio en las acciones.
RESOLVE Esta publicación resuelve el hilo.
REOPEN Esta publicación vuelve a abrir el hilo.

Estado

Son las opciones de estado del hilo de comentarios.

Enums
STATUS_UNSPECIFIED Valor predeterminado Este valor no se usa.
OPEN El hilo de comentarios está abierto.
RESOLVED Se resolvió el hilo de comentarios.