Method: users.labels.list

Enumera todas las etiquetas en el buzón del usuario.

Solicitud HTTP

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

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. 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

Si el proceso es satisfactorio, el cuerpo de la respuesta contiene datos con la siguiente estructura:

Representación JSON
{
  "labels": [
    {
      object (Label)
    }
  ]
}
Campos
labels[]

object (Label)

Lista de etiquetas. Ten en cuenta que cada recurso de etiqueta solo contiene un id, name, messageListVisibility, labelListVisibility y type. El método labels.get puede recuperar detalles adicionales de las etiquetas.

Permisos de autorización

Se necesita uno de los siguientes alcances de OAuth:

  • https://mail.google.com/
  • https://www.googleapis.com/auth/gmail.modify
  • https://www.googleapis.com/auth/gmail.readonly
  • https://www.googleapis.com/auth/gmail.labels
  • https://www.googleapis.com/auth/gmail.metadata

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