Method: spaces.messages.create

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

El método create() requiere la autenticación del usuario o de la app. Chat atribuye al 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 apps. 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 la 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 le atribuye la app de Chat mostrando su nombre. El contenido del mensaje solo puede incluir texto (text).

Mensaje enviado con la autenticación del usuario

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

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 de acceso

Parámetros
parent

string

Obligatorio. El nombre de 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 subproceso. Admite hasta 4,000 caracteres. Para iniciar o agregar una conversación, crea un mensaje y especifica una threadKey o la thread.name. Para ver un ejemplo de uso, consulta Cómo iniciar o responder una conversación de mensajes.

requestId

string

Opcional. Un ID de solicitud único para este mensaje. Si especificas un ID de solicitud existente, se muestra el mensaje creado con ese ID en lugar de crear un mensaje nuevo.

messageReplyOption

enum (MessageReplyOption)

Opcional. Especifica si un mensaje inicia una conversación o responde a una. Solo es compatible en los espacios con nombre.

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 del mensaje name).

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 mensajes diferentes.

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

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.

Enumeraciones
MESSAGE_REPLY_OPTION_UNSPECIFIED Predeterminado. Inicia una conversación nueva. Si usas esta opción, se ignorará cualquier thread ID o threadKey que se incluya.
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD Crea el mensaje como respuesta a la conversación especificada por thread ID o threadKey. Si falla, el mensaje inicia una nueva conversación.
REPLY_MESSAGE_OR_FAIL Crea el mensaje como respuesta a la conversación especificada por thread ID o threadKey. Si se usa un threadKey nuevo, se crea un subproceso nuevo. Si la creación del mensaje falla, se muestra un error NOT_FOUND en su lugar.