- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Alcances de la autorización
- MessageReplyOption
- Pruébala
Crea un mensaje en un espacio de Google Chat. El tamaño máximo de los mensajes, incluidos el texto y las tarjetas, es de 32,000 bytes. Para ver un ejemplo, consulta Envía un mensaje.
La llamada a este método requiere autenticación y admite los siguientes tipos de autenticación:
- En el caso de los mensajes de texto, se admite la autenticación de usuarios o de apps.
- Para los mensajes con tarjetas, solo se admite la autenticación de apps. (Solo las apps de Chat pueden crear mensajes de tarjetas).
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 |
Obligatorio. El nombre del recurso del espacio en el que se crea un mensaje. Formato: |
Parámetros de consulta
Parámetros | |
---|---|
threadKey |
Opcional. Obsoleto: usa |
requestId |
Opcional. Un ID de solicitud único para este mensaje. Cuando se especifica un ID de solicitud existente, se muestra el mensaje creado con ese ID en lugar de crear un mensaje nuevo. |
messageReplyOption |
Opcional. Especifica si un mensaje inicia una conversación o responde a una. Solo se admite en espacios con nombre. |
messageId |
Opcional. 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 El valor de este campo debe cumplir con los siguientes requisitos:
Para obtener más información, consulta Cómo asignar un nombre a un mensaje. |
Cuerpo de la solicitud
El cuerpo de la solicitud incluye 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 alcances 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.
Enumeradores | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Predeterminado. Inicia una conversación nueva. El uso de esta opción ignora todos los elementos thread ID o incluidos. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Crea el mensaje como respuesta a la conversación especificada por thread ID o . 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 . Si se usa un threadKey nuevo, se crea un subproceso nuevo. Si la creación del mensaje falla, en su lugar se muestra un error NOT_FOUND . |