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 Cómo actualizar un mensaje.

Admite los siguientes tipos de autenticación:

  • Autenticación de la app con el alcance de autorización:

    • https://www.googleapis.com/auth/chat.bot

  • Autenticación de usuarios con uno de los siguientes permisos de autorización:

    • https://www.googleapis.com/auth/chat.messages
    • https://www.googleapis.com/auth/chat.import (solo espacios de modo de importación)

Cuando se usa la autenticación de la app, 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

Es el identificador. Es el nombre del recurso del mensaje.

Formato: spaces/{space}/messages/{message}

Aquí, {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 estableces un ID personalizado cuando creas un mensaje, puedes usarlo para especificar el mensaje en una solicitud reemplazando {message} por el valor del campo clientAssignedMessageId. Por ejemplo, spaces/AAAAAAAAAAA/messages/client-custom-name. Para obtener más información, consulta Cómo nombrar un mensaje.

Parámetros de consulta

Parámetros
updateMask

string (FieldMask format)

Es obligatorio. Son las rutas de los campos que se actualizarán. Separa varios valores con comas o usa * para actualizar todas las rutas de campo.

Rutas de campos admitidas actualmente:
allowMissing

boolean

Opcional. Si no se encuentra true ni el mensaje, se crea un mensaje 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.