Etiketleri yönetin

Bu belgede, Gmail API kullanılarak ileti dizilerindeki ve iletilerdeki etiketlerin nasıl yönetileceği açıklanmaktadır.

Gmail'deki iletileri ve ileti dizilerini etiketlemek, düzenlemek ve kategorilere ayırmak için etiketleri kullanabilirsiniz. Etiketler iletiler ve ileti dizileri arasında çoka çok ilişkisi vardır: Tek bir iletiye veya ileti dizisine birden fazla etiket uygulayabilir, tek bir etiketi de birden fazla iletiye veya ileti dizisine uygulayabilirsiniz.

Etiketleri oluşturma, alma, listeleme, güncelleme veya silme hakkında bilgi edinmek için labels kaynağına bakın.

Etiketleri yönetmek için https://www.googleapis.com/auth/gmail.labels hassas olmayan kapsamını kullanmanız gerekir. Kapsamlar hakkında daha fazla bilgi için Gmail API kapsamlarını seçme başlıklı makaleyi inceleyin.

Etiket türleri

Etiketler iki türdedir: ayrılmış SYSTEM etiketler ve özel USER etiketler.

Sistem etiketleri genellikle Gmail web arayüzündeki INBOX gibi önceden tanımlanmış öğelere karşılık gelir. Sistem etiketi adları ayrılmıştır. USER etiketi, SYSTEM etiketiyle aynı adla oluşturulamaz. Aşağıdaki tabloda en yaygın Gmail sistem etiketlerinden bazıları listelenmiştir:

Ad	Manuel olarak uygulanabilir.	Notlar
INBOX	evet
SPAM	evet
TRASH	evet
UNREAD	evet
STARRED	evet
IMPORTANT	evet
SENT	hayır	Aşağıdaki iletilere otomatik olarak uygulanır: drafts.send veya messages.send ile gönderilmişse. messages.insert ile eklenir ve kullanıcının e-posta adresi From üstbilgisinde yer alır. kullanıcı tarafından web arayüzü üzerinden gönderilenler
DRAFT	hayır	Gmail API veya Gmail arayüzü ile oluşturulan tüm draft iletilere otomatik olarak uygulanır.
CATEGORY_PERSONAL	evet	Gmail arayüzünün Kişisel sekmesinde gösterilen iletilere karşılık gelir.
CATEGORY_SOCIAL	evet	Gmail arayüzünün Sosyal sekmesinde gösterilen iletilere karşılık gelir.
CATEGORY_PROMOTIONS	evet	Gmail arayüzünün Tanıtımlar sekmesinde gösterilen iletilere karşılık gelir.
CATEGORY_UPDATES	evet	Gmail arayüzünün Güncellemeler sekmesinde gösterilen iletilere karşılık gelir.
CATEGORY_FORUMS	evet	Gmail arayüzünün Forumlar sekmesinde gösterilen iletilere karşılık gelir.

İleti dizilerindeki ve iletilerdeki etiketleri yönetme

Etiketler yalnızca iletilerde bulunur. Bir ileti dizisindeki etiketlerin listesini alırsanız ileti dizisindeki herhangi bir iletide bulunan etiketlerin listesini görürsünüz. Bir ileti dizisindeki her iletide etiket olmayabilir.

Taslak iletilere etiket uygulayamazsınız.

İş parçacıklarına etiket ekleme veya kaldırma

Bir ileti dizisine etiket eklediğinizde veya ileti dizisinden etiket kaldırdığınızda, ileti dizisindeki tüm mevcut iletilere belirtilen etiket eklenir veya bu iletilerden belirtilen etiket kaldırılır.

Bir ileti dizisine etiket ekledikten sonra ileti eklenirse yeni iletiler, ileti dizisiyle ilişkili mevcut etiketi devralmaz. Etiketi bu iletilere eklemek için etiketi ileti dizisine tekrar ekleyin.

Bir ileti dizisiyle ilişkili etiketleri eklemek veya kaldırmak için threads.modify simgesini kullanın.

İletilere etiket ekleme veya iletilerden etiket kaldırma

Bir iletiye etiket eklediğinizde bu etiket iletiye eklenir ve iletinin ait olduğu ileti dizisiyle ilişkilendirilir. Etiket, ileti dizisindeki diğer iletilere eklenmez.

Bir iletinin etiketini kaldırdığınızda ve bu ileti, ileti dizisinde söz konusu etikete sahip tek iletiyse etiket, ileti dizisinden de kaldırılır.

Bir iletiye uygulanan etiketleri eklemek veya kaldırmak için messages.modify simgesini kullanın.