Method: spaces.messages.update
Actualiza un mensaje. Hay una diferencia entre los métodos patch
y update
. El método patch
usa una solicitud patch
, mientras que el método update
usa una solicitud put
. Te recomendamos que uses el método patch
. Para ver un ejemplo, consulta Actualiza un mensaje.
Admite los siguientes tipos de autenticación:
Cuando usas la autenticación de apps, las solicitudes solo pueden actualizar los mensajes creados por la app de Chat que realiza la llamada.
Solicitud HTTP
PUT https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros |
message.name |
string
Identificador. Es el nombre del recurso del mensaje. Formato: spaces/{space}/messages/{message} En el que {space} es el ID del espacio en el que se publicó el mensaje y {message} es un ID asignado por el sistema para el mensaje. Por ejemplo, spaces/AAAAAAAAAAA/messages/BBBBBBBBBBB.BBBBBBBBBBB . Si configuras un ID personalizado cuando creas un mensaje, puedes usar este ID para especificar el mensaje en una solicitud. Para ello, reemplaza {message} por el valor del campo clientAssignedMessageId . Por ejemplo, spaces/AAAAAAAAAAA/messages/client-custom-name . Para obtener más información, consulta Cómo asignar un nombre a un mensaje.
|
Parámetros de consulta
Parámetros |
updateMask |
string (FieldMask format)
Obligatorio. Las rutas de campo que se actualizarán. Separa varios valores con comas o usa * para actualizar todas las rutas de campo. Rutas de campo admitidas actualmente:
|
allowMissing |
boolean
Opcional. Si no se encuentra true ni el mensaje, se crea uno nuevo y se ignora updateMask . El ID de mensaje especificado debe ser asignado por el cliente o la solicitud fallará.
|
Cuerpo de la solicitud
El cuerpo de la solicitud contiene una instancia de Message
.
Cuerpo de la respuesta
Si se ejecuta de forma correcta, el cuerpo de la respuesta contiene una instancia de Message
.
Alcances 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
Para obtener más información, consulta la Guía de autorización.
Salvo que se indique lo contrario, el contenido de esta página está sujeto a la licencia Atribución 4.0 de Creative Commons, y los ejemplos de código están sujetos a la licencia Apache 2.0. Para obtener más información, consulta las políticas del sitio de Google Developers. Java es una marca registrada de Oracle o sus afiliados.
Última actualización: 2024-11-04 (UTC)
[null,null,["Última actualización: 2024-11-04 (UTC)"],[[["Updates a Google Chat message using the `PUT` method, preferably with the `patch` approach for partial modifications."],["Requires providing the message's resource name in the URL path for identification."],["Allows specifying fields to update using `updateMask` and supports creating a new message if the original is missing with `allowMissing` set to `true`."],["Authentication can be done using app authentication or user authentication, with app authentication restricting updates to messages created by the calling Chat app."],["Needs authorization with specific OAuth scopes like `chat.bot`, `chat.import`, or `chat.messages`."]]],["This describes updating messages in Google Chat using either `patch` or `put` requests, recommending `patch`. The `PUT` request uses the format `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. Updating requires specifying the `message.name` path parameter and the `updateMask` query parameter to identify fields to modify. Optional `allowMissing` creates a new message if one is not found. The request and response body are `Message` instances. Authorization requires specific OAuth scopes. App authentication can update messages from the calling app only.\n"]]