Method: spaces.messages.create

Crea un mensaje en un espacio de Google Chat. Para ver un ejemplo, consulta Envía un mensaje.

Admite los siguientes tipos de autenticación:

  • Autenticación de la app con el permiso de autorización:
    • https://www.googleapis.com/auth/chat.bot
  • Autenticación del usuario con uno de los siguientes permisos de autorización:
    • https://www.googleapis.com/auth/chat.messages.create
    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (solo espacios en modo de importación)

Chat atribuye el remitente del mensaje de manera diferente según el tipo de autenticación que uses en tu solicitud.

En la siguiente imagen, se muestra cómo Chat atribuye un mensaje cuando usas la autenticación de la app. Chat muestra la app de Chat como el remitente del mensaje. El contenido del mensaje puede incluir texto (text), tarjetas (cardsV2) y widgets de accesorios (accessoryWidgets).

Mensaje enviado con autenticación de la app

En la siguiente imagen, se muestra cómo Chat atribuye un mensaje cuando usas la autenticación de usuario. Chat muestra al usuario como el remitente del mensaje y atribuye la app de Chat al mensaje mostrando su nombre. El contenido del mensaje solo puede incluir texto (text).

Mensaje enviado con autenticación del usuario

El tamaño máximo del mensaje, incluido su contenido, es de 32,000 bytes.

En el caso de las solicitudes de webhook, la respuesta no contiene el mensaje completo. La respuesta solo propaga los campos name y thread.name, además de la información que estaba en la solicitud.

Solicitud HTTP

POST https://chat.googleapis.com/v1/{parent=spaces/*}/messages

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta

Parámetros
parent

string

Obligatorio. Es el nombre del recurso del espacio en el que se creará un mensaje.

Formato: spaces/{space}

Parámetros de consulta

Parámetros
threadKey
(deprecated)

string

Opcional. Obsoleto: Usa thread.thread_key en su lugar. Es el ID del hilo. Admite hasta 4,000 caracteres. Para iniciar una conversación o agregar un mensaje a una existente, crea un mensaje y especifica un threadKey o el thread.name. Para ver un ejemplo de uso, consulta Cómo iniciar o responder una conversación de mensajes.

requestId

string

Opcional. Es un ID único para esta solicitud. Se recomienda un UUID aleatorio. Especificar un ID de solicitud hace que la solicitud sea idempotente, lo que garantiza que varias solicitudes idénticas con el mismo ID de solicitud generen un solo mensaje. Las solicitudes posteriores con el mismo ID de solicitud devuelven el mensaje existente y no lo actualizan, incluso si los detalles solicitados difieren del estado actual.

Para usar este campo de manera eficaz, haz lo siguiente:

  • Asegúrate de que las solicitudes posteriores sean idénticas y usen las mismas credenciales de autenticación que la solicitud original.
  • Si ya se creó un mensaje con el ID de solicitud proporcionado, la solicitud devuelve ese mensaje. Ten en cuenta que es posible que el mensaje que se devuelva no esté completo. La API repite el mensaje de tu solicitud con los nombres de recursos asignados por el sistema. Para recuperar los metadatos más recientes del mensaje, llama a messages.get.
  • Si reutilizas un ID de solicitud existente con un usuario autenticado diferente, se producirá un error.
messageReplyOption

enum (MessageReplyOption)

Opcional. Especifica si un mensaje inicia una conversación o responde a una. Solo se admite en espacios con nombre.

Cuando respondes a las interacciones de los usuarios, se ignora este campo. En el caso de las interacciones dentro de una conversación, la respuesta se crea en la misma conversación. De lo contrario, la respuesta se creará como un hilo nuevo.

messageId

string

Opcional. Es un ID personalizado para un mensaje. Permite que las apps de Chat obtengan, actualicen o borren un mensaje sin necesidad de almacenar el ID asignado por el sistema en el nombre del recurso del mensaje (representado en el campo name del mensaje).

El valor de este campo debe cumplir con los siguientes requisitos:

  • Comienza con client-. Por ejemplo, client-custom-name es un ID personalizado válido, pero custom-name no lo es.
  • Contiene hasta 63 caracteres y solo letras minúsculas, números y guiones.
  • Es único dentro de un espacio. Una app de Chat no puede usar el mismo ID personalizado para diferentes mensajes.

Para obtener más información, consulta Cómo asignar un nombre a un mensaje.

createMessageNotificationOptions

object (CreateMessageNotificationOptions)

Opcional. Controla el comportamiento de las notificaciones cuando se publica el mensaje. Para obtener más información, consulta Cómo forzar notificaciones o enviar mensajes silenciosos.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene una instancia de Message.

Cuerpo de la respuesta

Si el proceso se realiza de forma correcta, el cuerpo de la respuesta contiene una instancia recién creada de Message.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/chat.bot
  • https://www.googleapis.com/auth/chat.import
  • https://www.googleapis.com/auth/chat.messages
  • https://www.googleapis.com/auth/chat.messages.create

Para obtener más información, consulta la guía de autorización.

MessageReplyOption

Especifica cómo responder un mensaje. Es posible que se agreguen más estados en el futuro.

Enums
MESSAGE_REPLY_OPTION_UNSPECIFIED Predeterminado. Inicia un hilo nuevo. Si usas esta opción, se ignorarán los thread ID o threadKey que se incluyan.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea el mensaje como una respuesta al hilo especificado por thread ID o threadKey. Si falla, el mensaje iniciará un hilo nuevo.
REPLY_MESSAGE_OR_FAIL Crea el mensaje como una respuesta al hilo especificado por thread ID o threadKey. Si se usa un threadKey nuevo, se crea un hilo nuevo. Si falla la creación del mensaje, se devuelve un error NOT_FOUND.

CreateMessageNotificationOptions

Son las opciones para el comportamiento de las notificaciones cuando se publica el mensaje.

Representación JSON
{
  "notificationType": enum (NotificationType)
}
Campos
notificationType

enum (NotificationType)

Es el tipo de notificación del mensaje.

NotificationType

Son las opciones de tipos de notificaciones para el mensaje.

Enums
NOTIFICATION_TYPE_NONE Es el comportamiento predeterminado. El comportamiento de las notificaciones es similar al que se produce cuando el usuario humano envía el mensaje con la IU de Chat: no se envía ninguna notificación al remitente humano.
NOTIFICATION_TYPE_INCLUDE_HUMAN_CREATOR

Se envía una notificación (notificaciones push, notificaciones por correo electrónico, etc.) al usuario creador del mensaje (por ejemplo, el usuario cuya autenticación se usó para crear el mensaje) y el mensaje se marca como no leído.

Esto no anulará la configuración de notificaciones de usuario existente para el espacio. Por ejemplo, si el usuario eligió no recibir notificaciones de un espacio, no se le notificará, incluso si se establece esta opción.

Requiere autenticación de usuario.

NOTIFICATION_TYPE_FORCE_NOTIFY

Notifica a los destinatarios de forma forzada. Esto anula la configuración de notificaciones de los espacios de los usuarios y la configuración de No interrumpir de Chat. Esta opción no omite la configuración de No interrumpir a nivel del dispositivo.

Requiere autenticación de la app.

NOTIFICATION_TYPE_SILENT

No notifiques a los destinatarios ni marques el mensaje como no leído. Esto se comporta de manera similar a cuando el usuario silencia la conversación o habilita la opción No interrumpir de Chat.

Requiere autenticación de la app.