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 değişmez kimliği.
name

string

Etiketin görünen adı.
messageListVisibility

enum (MessageListVisibility)

Bu etikete sahip iletilerin Gmail web arayüzündeki ileti listesinde 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, kullanıcı tarafından değiştirilip silinebilir ve 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 ve ileti dizilerinden kaldırılabilir ancak bu garanti edilmez. Örneğin, kullanıcılar iletilere ve ileti dizilerine INBOX ve UNREAD etiketlerini uygulayabilir ve kaldırabilir ancak iletilere veya ileti dizilerine DRAFTS ya da SENT etiketlerini uygulayamaz veya kaldıramaz.
messagesTotal

integer

Etikete sahip toplam mesaj sayısı.
messagesUnread

integer

Etiketli okunmamış iletilerin sayısı.
threadsTotal

integer

Etikete sahip toplam ileti dizisi sayısı.
threadsUnread

integer

Etiketli okunmamış ileti dizilerinin sayısı.
color

object (Color)

Etikete atanacak renk. Renk yalnızca type ayarı user olarak belirlenen 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österir.
labelShowIfUnread Bu etikete sahip okunmamış iletiler varsa etiketi göster.
labelHide Etiketi etiket listesinde göstermeyin.

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. Etiket rengini ayarlamak için bu alan gereklidir. Yalnızca aşağıdaki önceden tanımlanmış renk değerleri grubuna 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

Arka plan rengi, #RRGGBB onaltılık dizesi olarak gösterilir (ör. #000000). Etiket rengini ayarlamak için bu alan gereklidir. Yalnızca aşağıdaki önceden tanımlanmış renk değerleri grubuna 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 hemen ve kalıcı olarak siler ve uygulandığı tüm ileti ve yazışma dizilerinden kaldırır.

get

 Belirtilen etiketi alır.

list

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

patch

 Belirtilen etiketi yamalayın.

update

 Belirtilen etiketi günceller.