Method: users.messages.modify

Modifica las etiquetas del mensaje especificado.

Solicitud HTTP

POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/{id}/modify

La URL usa la sintaxis de la transcodificación gRPC.

Parámetros de ruta de acceso

Parámetros
userId

string

La dirección de correo electrónico del usuario. El valor especial me se puede usar para indicar el usuario autenticado.
id

string

Es el ID del mensaje que se modificará.

Cuerpo de la solicitud

El cuerpo de la solicitud contiene datos con la siguiente estructura:

Representación JSON 
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ]
}
Campos
addLabelIds[]

string

Es una lista de IDs de etiquetas que se agregarán a este mensaje. Puedes agregar hasta 100 etiquetas con cada actualización.
removeLabelIds[]

string

Es una lista de IDs de etiquetas que se quitarán de este mensaje. Puedes quitar hasta 100 etiquetas con cada actualización.

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://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify

Para obtener más información, consulta la Guía de autorización.