Method: spaces.messages.patch
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 se usa la autenticación de apps, las solicitudes solo pueden actualizar los mensajes creados por la app de Chat que realiza la llamada.
Solicitud HTTP
PATCH 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 `PATCH` method, preferably over the `update` method which uses `PUT`."],["Supports both app and user authentication, with app authentication limited to updating messages created by the calling Chat app."],["Requires specifying the message to update using its resource name in the URL path and the fields to update using the `updateMask` query parameter."],["Allows creation of a new message if the original is not found when `allowMissing` query parameter is set to `true` and a client-assigned message ID is provided."],["Requires authorization with one of the specified OAuth scopes (`chat.bot`, `chat.import`, or `chat.messages`)."]]],["This documentation outlines how to update a message using the `PATCH` method via an HTTP request to `https://chat.googleapis.com/v1/{message.name=spaces/*/messages/*}`. The `message.name` path parameter is required, specifying the message's resource name. The `updateMask` query parameter is mandatory, indicating which fields to update (e.g., text, attachments). Optionally, `allowMissing` creates a new message if one isn't found. The request and response bodies utilize the `Message` resource, and app or user authentication are supported, with specific authentication impacting permissions.\n"]]