Anda dapat menggunakan label untuk memberi tag, mengatur, dan mengategorikan pesan dan rangkaian pesan di Gmail. Label memiliki hubungan many-to-many dengan pesan dan rangkaian pesan: Anda dapat menerapkan beberapa label ke satu pesan atau rangkaian pesan dan menerapkan satu label ke beberapa pesan atau rangkaian pesan.
Untuk mengetahui informasi tentang cara membuat, mendapatkan, mencantumkan, memperbarui, atau menghapus label, lihat Referensi label.
Untuk mengelola label, Anda harus menggunakan
cakupan https://www.googleapis.com/auth/gmail.labels. Untuk mengetahui informasi selengkapnya tentang cakupan, lihat Informasi otorisasi dan autentikasi khusus Gmail API.
Jenis label
Label tersedia dalam dua jenis: label SYSTEM yang dipesan dan label USER kustom.
Label sistem biasanya sesuai dengan elemen yang telah ditentukan sebelumnya di antarmuka web Gmail seperti kotak masuk. Nama label sistem sudah dicadangkan; tidak ada label USER yang dapat dibuat dengan nama yang sama dengan label SYSTEM. Tabel berikut mencantumkan beberapa label sistem Gmail yang paling umum:
| Nama | Dapat diterapkan secara manual | Catatan |
|---|---|---|
INBOX |
ya | |
SPAM |
ya | |
TRASH |
ya | |
UNREAD |
ya | |
STARRED |
ya | |
IMPORTANT |
ya | |
SENT |
tidak | Diterapkan secara otomatis ke pesan yang dikirim dengan
drafts.send atau
messages.send, disisipkan
dengan messages.insert
dan email pengguna di header From, atau dikirim oleh pengguna melalui
antarmuka web. |
DRAFT |
tidak | Diterapkan secara otomatis ke semua pesan draft yang dibuat dengan Gmail API atau antarmuka Gmail. |
CATEGORY_PERSONAL |
ya | Sesuai dengan pesan yang ditampilkan di tab Personal pada antarmuka Gmail. |
CATEGORY_SOCIAL |
ya | Sesuai dengan pesan yang ditampilkan di tab Sosial pada antarmuka Gmail. |
CATEGORY_PROMOTIONS |
ya | Sesuai dengan pesan yang ditampilkan di tab Promosi antarmuka Gmail. |
CATEGORY_UPDATES |
ya | Sesuai dengan pesan yang ditampilkan di tab Pembaruan pada antarmuka Gmail. |
CATEGORY_FORUMS |
ya | Sesuai dengan pesan yang ditampilkan di tab Forum pada antarmuka Gmail. |
Mengelola label pada pesan & rangkaian pesan
Label hanya ada pada pesan. Misalnya, jika Anda mencantumkan label pada rangkaian pesan, Anda akan mendapatkan daftar label yang ada pada pesan apa pun dalam rangkaian pesan tersebut. Label mungkin tidak ada di setiap pesan dalam rangkaian pesan. Anda dapat menerapkan beberapa label ke pesan, tetapi Anda tidak dapat menerapkan label ke pesan draf.
Menambahkan atau menghapus label ke rangkaian pesan
Saat Anda menambahkan atau menghapus label ke rangkaian pesan, Anda menambahkan atau menghapus label yang ditentukan pada semua pesan yang ada dalam rangkaian pesan.
Jika pesan ditambahkan ke rangkaian pesan setelah Anda menambahkan label, pesan baru tidak mewarisi label yang ada yang terkait dengan rangkaian pesan. Untuk menambahkan label ke pesan tersebut, tambahkan label ke rangkaian pesan lagi.
Untuk menambahkan atau menghapus label yang terkait dengan rangkaian pesan, gunakan
threads.modify.
Menambahkan atau menghapus label ke pesan
Saat Anda menambahkan label ke pesan, label tersebut akan ditambahkan ke pesan tersebut dan dikaitkan dengan rangkaian pesan yang berisi pesan tersebut. Label tidak ditambahkan ke pesan lain dalam rangkaian pesan.
Jika Anda menghapus label dari pesan dan pesan tersebut adalah satu-satunya pesan dalam rangkaian pesan yang memiliki label tersebut, label juga akan dihapus dari rangkaian pesan.
Untuk menambahkan atau menghapus label yang diterapkan ke pesan, gunakan
messages.modify.