Method: users.settings.filters.list

Enumera los filtros de mensajes de un usuario de Gmail. Para obtener más información, consulta Cómo administrar filtros de Gmail.

Solicitud HTTP

GET https://gmail.googleapis.com/gmail/v1/users/{userId}/settings/filters

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

Parámetros de ruta

Parámetros
userId

string

Dirección de correo electrónico del usuario. Se puede usar el valor especial "me" para indicar el usuario autenticado.

Cuerpo de la solicitud

El cuerpo de la solicitud debe estar vacío.

Cuerpo de la respuesta

Respuesta para el método filters.list.

Si se ejecuta correctamente, el cuerpo de la respuesta contendrá datos con la siguiente estructura:

Representación JSON 
{
  "filter": [
    {
      object (Filter)
    }
  ]
}
Campos
filter[]

object (Filter)

Lista de los filtros de un usuario.

Permisos de autorización

Se necesita uno de los siguientes permisos de OAuth:

  • https://www.googleapis.com/auth/gmail.settings.basic
  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly

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