Anda dapat menggunakan label untuk memberi tag, mengatur, dan mengategorikan pesan serta 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 informasi tentang cara create, 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 memiliki dua variasi: label SYSTEM yang direservasi dan label USER kustom.
Label sistem biasanya sesuai dengan elemen yang telah ditentukan sebelumnya di antarmuka web Gmail seperti kotak masuk. Nama label sistem dicadangkan; tidak ada label USER yang dapat
dibuat dengan nama yang sama seperti 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 Pribadi di 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 Info terbaru 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 di pesan. Misalnya, jika mencantumkan label di rangkaian pesan, Anda akan mendapatkan daftar label yang ada di salah satu pesan dalam rangkaian pesan. Label mungkin tidak ada di setiap pesan dalam rangkaian pesan. Anda dapat menerapkan beberapa label ke pesan, tetapi tidak dapat menerapkan label ke pesan draf.
Menambahkan atau menghapus label ke rangkaian pesan
Saat 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 tersebut tidak akan mewarisi label yang ada dan 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 akan ditambahkan ke pesan tersebut dan akan dikaitkan dengan rangkaian pesan tempat pesan tersebut berada. Label tidak ditambahkan ke pesan lain dalam rangkaian pesan.
Jika Anda menghapus label dari pesan dan pesan tersebut adalah satu-satunya pesan dalam rangkaian email dengan label tersebut, label juga akan dihapus dari rangkaian email.
Untuk menambahkan atau menghapus label yang diterapkan ke pesan, gunakan
messages.modify.