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 thread: 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 informasi selengkapnya tentang cakupan, lihat Informasi otorisasi dan autentikasi khusus API Gmail.
Jenis label
Label memiliki dua variasi: label SYSTEM yang dicadangkan dan label USER khusus.
Label sistem biasanya berkaitan dengan elemen yang telah ditetapkan 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 apa pun. 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 |
no | Diterapkan secara otomatis ke pesan yang dikirim dengan drafts.send atau messages.send, disisipkan dengan messages.insert dan email pengguna dalam header From, atau dikirim oleh pengguna melalui antarmuka web. |
DRAFT |
no | 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 antarmuka Gmail. |
CATEGORY_SOCIAL |
ya | Sesuai dengan pesan yang ditampilkan di tab Sosial 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 Update antarmuka Gmail. |
CATEGORY_FORUMS |
ya | Berhubungan 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 thread, Anda akan mendapatkan daftar label yang ada pada setiap pesan dalam thread. 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 pada rangkaian pesan, Anda menambah 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 akan mewarisi label yang ada yang terkait dengan rangkaian pesan tersebut. Untuk menambahkan label ke pesan tersebut, tambahkan kembali label ke rangkaian pesan.
Untuk menambahkan atau menghapus label yang terkait dengan thread, gunakan
threads.modify.
Menambahkan atau menghapus label pada pesan
Ketika Anda menambahkan label ke pesan, label ditambahkan ke pesan itu dan menjadi terkait 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 merupakan satu-satunya pesan dalam rangkaian pesan yang memiliki label tersebut, label juga akan dihapus dari rangkaian pesan.
Untuk menambahkan atau menghapus label yang diterapkan pada pesan, gunakan
messages.modify.