- Solicitud HTTP
- Parámetros de ruta de acceso
- Parámetros de consulta
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- MessageAnswerOption;
Crea un mensaje. Para ver un ejemplo, consulta Crea un mensaje.
Requiere autenticación.
Si creas un mensaje de texto, se admiten la autenticación de usuarios y la autenticación de apps. La autenticación de usuarios requiere el permiso de autorización chat.messages
o chat.messages.create
.
Para crear un mensaje de tarjeta, debes autenticar la app
Dado que Chat proporciona autenticación para los webhooks como parte de la URL que se genera cuando se registra un webhook, los webhooks pueden crear mensajes sin una cuenta de servicio o autenticación del usuario.
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 creará un mensaje. Formato: |
Parámetros de consulta
Parámetros | |
---|---|
threadKey |
Opcional. Obsoleto: Usa |
requestId |
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 |
Opcional. Especifica si un mensaje inicia una conversación o responde a una. Solo se admite en espacios con nombre. |
messageId |
Opcional. Un nombre personalizado para un mensaje de Chat asignado en el momento de su creación. Debe comenzar con |
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.
Opción de respuesta de mensajes
Especifica cómo responder a un mensaje. Es posible que se agreguen más estados en el futuro.
Enumeradores | |
---|---|
MESSAGE_REPLY_OPTION_UNSPECIFIED |
Predeterminado. Inicia un subproceso. |
REPLY_MESSAGE_FALLBACK_TO_NEW_THREAD |
Crea el mensaje como respuesta a la conversación especificada por thread ID o . Si falla, el mensaje iniciará una nueva conversación. |
REPLY_MESSAGE_OR_FAIL |
Crea el mensaje como respuesta a la conversación especificada por thread ID o . Si falla, se muestra un error NOT_FOUND . |