- Solicitud HTTP
- Parámetros de ruta de acceso
- Cuerpo de la solicitud
- Cuerpo de la respuesta
- Permisos de autorización
- Pruébala
Modifica las etiquetas de los mensajes especificados.
Solicitud HTTP
POST https://gmail.googleapis.com/gmail/v1/users/{userId}/messages/batchModify
La URL usa la sintaxis de la transcodificación gRPC.
Parámetros de ruta de acceso
Parámetros | |
---|---|
userId |
La dirección de correo electrónico del usuario. Se puede usar el valor especial |
Cuerpo de la solicitud
El cuerpo de la solicitud contiene datos con la siguiente estructura:
Representación JSON |
---|
{ "ids": [ string ], "addLabelIds": [ string ], "removeLabelIds": [ string ] } |
Campos | |
---|---|
ids[] |
Los ID de los mensajes que se modificarán. Existe un límite de 1000 IDs por solicitud. |
addLabelIds[] |
Una lista de los IDs de etiquetas que se agregarán a los mensajes. |
removeLabelIds[] |
Una lista de los ID de etiquetas que se quitarán de los mensajes. |
Cuerpo de la respuesta
Si se ejecuta correctamente, el cuerpo de la respuesta está vacío.
Permisos de autorización
Se necesita uno de los siguientes alcances 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.