Method: spaces.messages.create

• 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

Crea un mensaje. Para ver un ejemplo de uso, consulta Cómo crear un mensaje.

Requiere autenticación. Es totalmente compatible con la autenticación de cuentas de servicio.

Vista previa para desarrolladores: Admite la autenticación de usuarios como parte del Programa de vista previa para desarrolladores de Google Workspace, que otorga acceso anticipado a ciertas funciones. La autenticación de usuarios requiere el permiso de autorización chat.messages o chat.messages.create.

Debido a 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 ni autenticación de 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	string Obligatorio. El nombre del recurso del espacio en el que se crea un mensaje. Formato: espacios/{space}

Parámetros de consulta

Parámetros
threadKey (deprecated)	string Opcional. Obsoleto: usa thread.thread_key en su lugar. Es el identificador de subproceso opaco. Para iniciar o agregar una conversación, crea un mensaje y especifica un threadKey o un thread.name. Por ejemplo, consulta Cómo iniciar o responder una conversación de mensaje.
requestId	string Opcional. Un ID de solicitud único para este mensaje. Al especificar 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 se admite en los espacios con nombre.
messageId	string Opcional. Un nombre personalizado para un mensaje de Chat asignado al momento de su creación. Debe comenzar con client- y contener solo letras minúsculas, números y guiones de hasta 63 caracteres. Especifica este campo para obtener, actualizar o borrar el mensaje con el valor especificado. Para ver un ejemplo de uso, consulta Asigna un nombre a un mensaje creado.

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.

Alcances de la autorización

Se necesita uno de los siguientes alcances de OAuth:

• https://www.googleapis.com/auth/chat.bot
• 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 mensaje de respuesta

Especifica cómo responder 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 en respuesta a la conversación especificada por thread ID o threadKey. Si falla, el mensaje iniciará una nueva conversación.
REPLY_MESSAGE_OR_FAIL	Crea el mensaje en respuesta a la conversación especificada por thread ID o threadKey. Si falla, se muestra un error NOT_FOUND.