Method: spaces.messages.create

Crea un mensaje en un espacio de Google Chat. Para ver un ejemplo, consulta Cómo crear un mensaje.

Para llamar a este método, se requiere autenticación y se admiten 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 tarjeta).

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 una conversación o agregarla a ella, crea un mensaje y especifica un threadKey o el thread.name. Para ver ejemplos 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 se admite en espacios con nombre.
messageId

string

Opcional. Un nombre personalizado para un mensaje de Chat que se asigna al momento de su creación. Debe comenzar con client- y contener solo letras minúsculas, números y guiones de hasta 63 caracteres de longitud. Especifica este campo para obtener, actualizar o borrar el mensaje con el valor especificado. La asignación de un nombre personalizado permite que una app de Chat recupere el mensaje sin guardar el name del mensaje del cuerpo de la respuesta que se mostró cuando se creó el mensaje. La asignación de un nombre personalizado no reemplaza el campo name generado, el nombre del recurso del mensaje. En su lugar, establece el nombre personalizado como el campo clientAssignedMessageId, al que puedes hacer referencia mientras procesas operaciones posteriores, como actualizar o borrar el mensaje. Para ver ejemplos de uso, consulta Cómo nombrar 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.

Permisos 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.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 nueva conversación. 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 a la conversación especificada por thread ID o threadKey. Si se produce un error, el mensaje inicia una conversación nueva.
REPLY_MESSAGE_OR_FAIL Crea el mensaje como una respuesta a la conversación especificada por thread ID o threadKey. Si se usa un threadKey nuevo, se crea un subproceso nuevo. Si falla la creación del mensaje, se muestra un error NOT_FOUND en su lugar.