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:
|
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.