REST Resource: spaces.messages

{
  "name": string,
  "sender": {
    object (User)
  },
  "createTime": string,
  "lastUpdateTime": string,
  "deleteTime": string,
  "text": string,
  "formattedText": string,
  "cards": [
    {
      object (Card)
    }
  ],
  "cardsV2": [
    {
      object (CardWithId)
    }
  ],
  "annotations": [
    {
      object (Annotation)
    }
  ],
  "thread": {
    object (Thread)
  },
  "space": {
    object (Space)
  },
  "fallbackText": string,
  "actionResponse": {
    object (ActionResponse)
  },
  "argumentText": string,
  "slashCommand": {
    object (SlashCommand)
  },
  "attachment": [
    {
      object (Attachment)
    }
  ],
  "matchedUrl": {
    object (MatchedUrl)
  },
  "threadReply": boolean,
  "clientAssignedMessageId": string,
  "emojiReactionSummaries": [
    {
      object (EmojiReactionSummary)
    }
  ],
  "deletionMetadata": {
    object (DeletionMetadata)
  },
  "quotedMessageMetadata": {
    object (QuotedMessageMetadata)
  },
  "attachedGifs": [
    {
      object (AttachedGif)
    }
  ]
}

string

Nombre del recurso con el formato spaces/*/messages/*.

Ejemplo: spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB

object (User)

Solo salida. El usuario que creó el mensaje. Si tu app de Chat se autentica como un usuario, el resultado propaga el name y type del usuario.

string (Timestamp format)

Para los espacios creados en Chat, la hora a la que se creó el mensaje. Este campo es de solo salida, excepto cuando se usa en espacios importados.

string (Timestamp format)

Solo salida. La hora en la que un usuario editó el mensaje por última vez. Si el mensaje nunca se editó, este campo estará vacío.

string (Timestamp format)

Solo salida. La hora a la que se borró el mensaje en Google Chat. Si el mensaje nunca se borra, este campo estará vacío.

string

Es el cuerpo con texto sin formato del mensaje. El primer vínculo a una imagen, un video o una página web genera un chip de vista previa. También puedes @mencionar a un usuario de Google Chat o a todas las personas del espacio.

Para obtener información sobre cómo crear mensajes de texto, consulta Cómo enviar un mensaje de texto.

string

Solo salida. Contiene el mensaje text con lenguaje de marcado agregado para comunicar el formato. Es posible que este campo no capture todo el formato visible en la IU, pero incluye lo siguiente:

• Sintaxis de lenguaje de marcado para bloques de negrita, cursiva, tachado, monoespacial y monoespacial
• Menciones de usuarios con el formato <users/{user}>.
• Hipervínculos personalizados con el formato <{url}|{rendered_text}>, donde la primera string es la URL y la segunda es el texto renderizado, por ejemplo, <http://example.com|custom text>.
• Emojis personalizados con el formato :{emoji_name}:, por ejemplo, :smile:. Esto no se aplica a los emojis Unicode, como U+1F600 para un emoji con una cara sonriente.

Para obtener más información, consulta Cómo ver el formato de texto enviado en un mensaje

object (Card)

Obsoleto: usa cardsV2 en su lugar.

Tarjetas enriquecidas, interactivas y con formato que puedes usar para mostrar elementos de la IU, como textos con formato, imágenes en las que se puede hacer clic y botones. Por lo general, las tarjetas se muestran debajo del cuerpo con texto sin formato del mensaje. cards y cardsV2 pueden tener un tamaño máximo de 32 KB.

object (CardWithId)

Array de tarjetas.

Solo las apps de Chat pueden crear tarjetas. Si tu app de Chat se autentica como un usuario, los mensajes no pueden contener tarjetas.

Para obtener más información sobre las tarjetas y cómo crearlas, consulta Cómo diseñar IUs dinámicas, interactivas y coherentes con tarjetas.

object (Annotation)

Solo salida. Son anotaciones asociadas con el text en este mensaje.

object (Thread)

La conversación a la que pertenece el mensaje. Para ver ejemplos de uso, consulta Cómo iniciar o responder una conversación de mensajes.

object (Space)

Si tu app de Chat se autentica como un usuario, el resultado propaga el espacio name.

string

Descripción de texto sin formato de las tarjetas del mensaje, que se usa cuando no se pueden mostrar las tarjetas reales; por ejemplo, notificaciones móviles.

object (ActionResponse)

Solo entrada. Parámetros que una app de Chat puede usar para configurar cómo se publica su respuesta

string

Solo salida. Cuerpo con texto sin formato del mensaje sin todas las menciones de la app de Chat.

object (SlashCommand)

Solo salida. Información del comando de barra, si corresponde.

object (Attachment)

Archivo adjunto subido por el usuario.

object (MatchedUrl)

Solo salida. Una URL en spaces.messages.text que coincide con un patrón de vista previa del vínculo. Si deseas obtener más información, consulta Cómo obtener una vista previa de los vínculos.

boolean

Solo salida. Cuando es true, el mensaje es una respuesta en una conversación. Si se muestra false, el mensaje se verá en la conversación de nivel superior del espacio como el primer mensaje de una conversación o como un mensaje sin respuestas en forma de conversación.

Si el espacio no admite respuestas en conversaciones, este campo siempre será false.

string

Un nombre personalizado para un mensaje de Chat que se asigna al momento de su creación. Debe comenzar con client- y contener solo letras minúsculas, números y guiones de hasta 63 caracteres de longitud. Especifica este campo para obtener, actualizar o borrar el mensaje con el valor especificado. La asignación de un nombre personalizado permite que una app de Chat recupere el mensaje sin guardar el name del mensaje del cuerpo de la respuesta que se mostró cuando se creó el mensaje. La asignación de un nombre personalizado no reemplaza el campo name generado, el nombre del recurso del mensaje. En su lugar, establece el nombre personalizado como el campo clientAssignedMessageId, al que puedes hacer referencia mientras procesas operaciones posteriores, como actualizar o borrar el mensaje. Para ver ejemplos de uso, consulta Cómo nombrar un mensaje creado.

object (EmojiReactionSummary)

Solo salida. Lista de resúmenes de reacciones con emojis del mensaje.

object (DeletionMetadata)

Solo salida. Información sobre un mensaje borrado. Cuando se configura deleteTime, se borra un mensaje.

object (QuotedMessageMetadata)

Solo salida. Información sobre un mensaje citado por un usuario de Google Chat en un espacio. Los usuarios de Google Chat pueden citar un mensaje para responderlo.

object (AttachedGif)

Solo salida. Son las imágenes GIF adjuntas al mensaje.

{
  "cardId": string,
  "card": {
    object (Card)
  }
}

string

Es obligatorio si el mensaje contiene varias tarjetas. Es el identificador único de una tarjeta en un mensaje.

object (Card)

Una tarjeta El tamaño máximo es de 32 KB.

{
  "type": enum (AnnotationType),
  "length": integer,
  "startIndex": integer,

  // Union field metadata can be only one of the following:
  "userMention": {
    object (UserMentionMetadata)
  },
  "slashCommand": {
    object (SlashCommandMetadata)
  }
  // End of list of possible types for union field metadata.
}

enum (AnnotationType)

Es el tipo de esta anotación.

integer

Longitud de la substring en el cuerpo del mensaje de texto sin formato a la que corresponde esta anotación.

integer

Índice de inicio (basado en 0, inclusivo) en el cuerpo del mensaje de texto sin formato al que corresponde esta anotación.

object (UserMentionMetadata)

Los metadatos de la mención del usuario.

object (SlashCommandMetadata)

Los metadatos para un comando de barra.

{
  "user": {
    object (User)
  },
  "type": enum (Type)
}

object (User)

El usuario mencionado.

enum (Type)

Es el tipo de mención del usuario.

{
  "bot": {
    object (User)
  },
  "type": enum (Type),
  "commandName": string,
  "commandId": string,
  "triggersDialog": boolean
}

object (User)

La app de Chat cuyo comando se invocó.

enum (Type)

El tipo de comando de barra.

string

El nombre del comando de barra invocado.

string (int64 format)

El ID del comando de barra invocado.

boolean

Indica si el comando de barra es para un diálogo.

{
  "name": string,
  "threadKey": string
}

string

Solo salida. Es el nombre del recurso del subproceso.

Ejemplo: spaces/{space}/threads/{thread}

string

Opcional. Entrada para crear o actualizar un subproceso. De lo contrario, solo salida. Es el ID del subproceso. Admite hasta 4,000 caracteres.

Este ID es exclusivo de la app de Chat que lo establece. Por ejemplo, si varias apps de Chat crean un mensaje con la misma clave de conversación, los mensajes se publican en diferentes conversaciones. Si, en cambio, quieres responder en una conversación creada por una persona o por otra app de Chat, especifica el campo name de la conversación.

{
  "type": enum (ResponseType),
  "url": string,
  "dialogAction": {
    object (DialogAction)
  }
}

enum (ResponseType)

Solo entrada. El tipo de respuesta de la app de Chat.

string

Solo entrada. URL para que los usuarios se autentiquen o configuren. (Solo para REQUEST_CONFIG tipos de respuesta).

object (DialogAction)

Solo entrada. Es una respuesta a un evento relacionado con un diálogo. Debe estar acompañado de ResponseType.Dialog.

{
  "actionStatus": {
    object (ActionStatus)
  },

  // Union field action can be only one of the following:
  "dialog": {
    object (Dialog)
  }
  // End of list of possible types for union field action.
}

object (ActionStatus)

Solo entrada. Estado de una solicitud para invocar o enviar un diálogo. Muestra un estado y un mensaje a los usuarios, si es necesario. Por ejemplo, en caso de error o éxito.

object (Dialog)

Solo entrada. Diálogo para la solicitud.

{
  "body": {
    object (Card)
  }
}

object (Card)

Solo entrada. Cuerpo del diálogo, que se renderiza en una ventana modal. Las apps de Google Chat no admiten las siguientes entidades de tarjetas: DateTimePicker y OnChangeAction.

{
  "statusCode": enum (Code),
  "userFacingMessage": string
}

enum (Code)

Es el código de estado.

string

Es el mensaje que se envía a los usuarios sobre el estado de su solicitud. Si no se configura, se envía un mensaje genérico basado en statusCode.

{
  "commandId": string
}

string (int64 format)

El ID del comando de barra invocado.

{
  "url": string
}

string

Solo salida. La URL que coincidió.

{
  "emoji": {
    object (Emoji)
  },
  "reactionCount": integer
}

object (Emoji)

Emoji asociado con las reacciones.

integer

La cantidad total de reacciones que usaron el emoji asociado.

{
  "deletionType": enum (DeletionType)
}

enum (DeletionType)

Indica quién borró el mensaje.

{
  "name": string,
  "lastUpdateTime": string
}

string

Solo salida. Nombre de recurso del mensaje citado.

Formato: spaces/{space}/messages/{message}

string (Timestamp format)

Solo salida. La marca de tiempo del momento en que se creó el mensaje citado o cuando se actualizó por última vez.

{
  "uri": string
}

string

Solo salida. La URL que aloja la imagen GIF.