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 kutusunda 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)

Gmail web arayüzündeki etiket listesinde etiketin görünürlüğü.
type

enum (Type)

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

integer

Etiketin bulunduğu toplam mesaj sayısı.
messagesUnread

integer

Etiketin bulunduğu okunmamış mesajların sayısı.
threadsTotal

integer

Etiketin bulunduğu ileti dizilerinin toplam sayısı.
threadsUnread

integer

Etiketin bulunduğu okunmamış ileti 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österin.
hide Etiketi ileti listesinde gösterme.

LabelListVisibility

Sıralamalar
labelShow Etiketi etiket listesinde gösterin.
labelShowIfUnread Bu etikete sahip okunmamış iletiler varsa etiketi gösterin.
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

Onaltılık dize olarak temsil edilen etiketin metin rengi. Bu alan, etiketin rengini ayarlamak için gereklidir. Yalnızca aşağıdaki önceden tanımlanmış renk değerlerine izin verilir:
#000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765
backgroundColor

string

#RRGGBB onaltılık dizesi olarak temsil edilen arka plan rengi (ör. #000000). Bu alan, etiketin rengini ayarlamak için gereklidir. Yalnızca aşağıdaki önceden tanımlanmış renk değerlerine izin verilir:
#000000, #434343, #666666, #999999, #cccccc, #efefef, #f3f3f3, #ffffff, #fb4c2f, #ffad47, #fad165, #16a766, #43d692, #4a86e8, #a479e2, #f691b3, #f6c5be, #ffe6c7, #fef1d1, #b9e4d0, #c6f3de, #c9daf8, #e4d7f5, #fcdee8, #efa093, #ffd6a2, #fce8b3, #89d3b2, #a0eac9, #a4c2f4, #d0bcf1, #fbc8d9, #e66550, #ffbc6b, #fcda83, #44b984, #68dfa9, #6d9eeb, #b694e8, #f7a7c0, #cc3a21, #eaa041, #f2c960, #149e60, #3dc789, #3c78d8, #8e63ce, #e07798, #ac2b16, #cf8933, #d5ae49, #0b804b, #2a9c68, #285bac, #653e9b, #b65775, #822111, #a46a21, #aa8831, #076239, #1a764d, #1c4587, #41236d, #83334c #464646, #e7e7e7, #0d3472, #b6cff5, #0d3b44, #98d7e4, #3d188e, #e3d7ff, #711a36, #fbd3e0, #8a1c0a, #f2b2a8, #7a2e0b, #ffc8af, #7a4706, #ffdeb5, #594c05, #fbe983, #684e07, #fdedc1, #0b4f30, #b3efd3, #04502e, #a2dcc1, #c2c2c2, #4986e7, #2da2bb, #b99aff, #994a64, #f691b2, #ff7537, #ffad46, #662e37, #ebdbde, #cca6ac, #094228, #42d692, #16a765

Yöntemler

create

 Yeni bir etiket oluşturur.

delete

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

get

 Belirtilen etiketi alır.

list

 Kullanıcının posta kutusunda bulunan tüm etiketleri listeler.

patch

 Belirtilen etikete yama uygulayın.

update

 Belirtilen etiketi günceller.