REST Resource: users.labels

Kaynak: Etiket

Etiketler, kullanıcının posta kutusundaki iletileri ve ileti dizilerini kategorilere ayırmak için kullanılır. Bir kullanıcının posta kutusu için desteklenen maksimum etiket sayısı 10.000'dir.

JSON gösterimi
{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
Alanlar
id

string

Etiketin sabit kimliği.

name

string

Etiketin görünen adı.

messageListVisibility

enum (MessageListVisibility)

Gmail web arayüzündeki ileti listesinde bu etikete sahip iletilerin görünürlüğü.

labelListVisibility

enum (LabelListVisibility)

Etiketin, Gmail web arayüzündeki etiket listesinde görünürlüğü.

type

enum (Type)

Etiketin sahip türü. Kullanıcı etiketleri kullanıcı tarafından oluşturulur. Etiketler kullanıcı tarafından değiştirilebilir, silinebilir ve herhangi bir iletiye veya ileti dizisine uygulanabilir. Sistem etiketleri dahili olarak oluşturulur ve eklenemez, değiştirilemez veya silinemez. Bazı durumlarda sistem etiketleri iletilere ve ileti dizilerine uygulanabilir ya da ileti dizilerinden kaldırılabilir. Ancak bu durum garanti edilmez. Örneğin, kullanıcılar iletilere ve ileti dizilerine INBOX ve UNREAD etiketlerini uygulayıp kaldırabilir, ancak iletilerden veya ileti dizilerinden DRAFTS ya da SENT etiketlerini uygulayamaz veya kaldıramaz.

messagesTotal

integer

Bu etikete sahip toplam ileti sayısı.

messagesUnread

integer

Bu etikete sahip okunmamış iletilerin sayısı.

threadsTotal

integer

Etiketteki toplam ileti dizisi sayısı.

threadsUnread

integer

Bu etikete sahip okunmamış mesaj dizilerinin sayısı.

color

object (Color)

Etikete atanacak renk. Renk, yalnızca type özelliği user olarak ayarlanmış etiketlerde kullanılabilir.

MessageListVisibility

Sıralamalar
show Etiketi ileti listesinde göster.
hide Etiketi ileti listesinde gösterme.

LabelListVisibility

Sıralamalar
labelShow Etiketi, etiket listesinde gösterin.
labelShowIfUnread Bu etikete sahip okunmamış iletiler varsa etiketi gösterir.
labelHide Etiketi, etiket listesinde gösterme.

Tür

Sıralamalar
system Gmail tarafından oluşturulan etiketler.
user Kullanıcı veya uygulama tarafından oluşturulan özel etiketler.

Renk

JSON gösterimi
{
  "textColor": string,
  "backgroundColor": string
}
Alanlar
textColor

string

Etiketin metin rengi (onaltılık dize olarak gösterilir). Bu alan, bir etiketin rengini ayarlamak için gereklidir. Yalnızca şu önceden tanımlanmış renk değerleri kümesine izin verilir:

backgroundColor

string

Onaltılık dize #RRGGBB olarak temsil edilen arka plan rengi (ör. #000000). Bu alan, bir etiketin rengini ayarlamak için gereklidir. Yalnızca aşağıdaki önceden tanımlanmış renk değerleri kümesine izin verilir:

Yöntemler

create

Yeni bir etiket oluşturur.

delete

Belirtilen etiketi hemen ve kalıcı olarak siler ve etiketin uygulandığı tüm iletilerden ve ileti dizilerinden kaldırır.

get

Belirtilen etiketi alır.

list

Kullanıcının posta kutusundaki tüm etiketleri listeler.

patch

Belirtilen etikete yama uygulayın.

update

Belirtilen etiketi günceller.