REST Resource: users.labels

Ressource: Label

Mit Labels werden Nachrichten und Threads im Posteingang des Nutzers kategorisiert. Für das Postfach eines Nutzers werden maximal 10.000 Labels unterstützt.

JSON-Darstellung
{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
Felder
id

string

Die unveränderliche ID des Labels.

name

string

Der Anzeigename des Labels.

messageListVisibility

enum (MessageListVisibility)

Die Sichtbarkeit von Nachrichten mit diesem Label in der Nachrichtenliste der Gmail-Weboberfläche.

labelListVisibility

enum (LabelListVisibility)

Die Sichtbarkeit des Labels in der Labelliste in der Gmail-Weboberfläche.

type

enum (Type)

Der Inhabertyp für das Label. Nutzerlabels werden vom Nutzer erstellt, können vom Nutzer geändert und gelöscht werden und auf alle Nachrichten oder Threads angewendet werden. Systemlabels werden intern erstellt und können nicht hinzugefügt, geändert oder gelöscht werden. Unter bestimmten Umständen können Systemlabels auf Nachrichten und Threads angewendet oder daraus entfernt werden. Dies ist jedoch nicht garantiert. Nutzer können beispielsweise die Labels INBOX und UNREAD auf Nachrichten und Threads anwenden und entfernen, aber nicht die Labels DRAFTS oder SENT auf Nachrichten oder Threads anwenden oder entfernen.

messagesTotal

integer

Die Gesamtzahl der Nachrichten mit dem Label.

messagesUnread

integer

Die Anzahl der ungelesenen Nachrichten mit dem Label.

threadsTotal

integer

Die Gesamtzahl der Threads mit dem Label.

threadsUnread

integer

Die Anzahl der ungelesenen Threads mit dem Label.

color

object (Color)

Die Farbe, die dem Label zugewiesen werden soll. Die Farbe ist nur für Labels verfügbar, deren type auf user gesetzt ist.

Sichtbarkeit von MessageList

Enums
show Label in der Nachrichtenliste anzeigen.
hide Label nicht in der Nachrichtenliste anzeigen.

Sichtbarkeit der Labelliste

Enums
labelShow Label in der Labelliste anzeigen.
labelShowIfUnread Das Label wird angezeigt, wenn ungelesene Nachrichten mit diesem Label vorhanden sind.
labelHide Label nicht in der Labelliste anzeigen.

Typ

Enums
system Von Gmail erstellte Labels.
user Benutzerdefinierte Labels, die vom Nutzer oder der Anwendung erstellt wurden.

Farbe

JSON-Darstellung
{
  "textColor": string,
  "backgroundColor": string
}
Felder
textColor

string

Die Textfarbe des Labels, angegeben als Hexadezimalstring. Dieses Feld ist erforderlich, um die Farbe eines Labels festzulegen. 13.3 - 136 - 136 - 236 - 236 n n 133 }

backgroundColor

string

Die Hintergrundfarbe als Hexadezimalstring #RRGGBB (z. B. #000000). Dieses Feld ist erforderlich, um die Farbe eines Labels festzulegen. 13.3 - 136 - 136 - 236 - 236 n n 133 }

Methoden

create

Erstellt ein neues Label.

delete

Das angegebene Label wird sofort und endgültig gelöscht und aus allen Nachrichten und Threads entfernt, auf die es angewendet wurde.

get

Ruft das angegebene Label ab.

list

Listet alle Labels im Postfach des Nutzers auf.

patch

Patchen Sie das angegebene Label.

update

Aktualisiert das angegebene Label.