REST Resource: users.labels

Resource: Label

Label digunakan untuk mengategorikan pesan dan rangkaian pesan dalam kotak surat pengguna. Jumlah maksimum label yang didukung untuk kotak surat pengguna adalah 10.000.

Representasi JSON 
{
  "id": string,
  "name": string,
  "messageListVisibility": enum (MessageListVisibility),
  "labelListVisibility": enum (LabelListVisibility),
  "type": enum (Type),
  "messagesTotal": integer,
  "messagesUnread": integer,
  "threadsTotal": integer,
  "threadsUnread": integer,
  "color": {
    object (Color)
  }
}
Kolom
id

string

ID yang tidak dapat diubah dari label.
name

string

Nama tampilan label.
messageListVisibility

enum (MessageListVisibility)

Visibilitas pesan dengan label ini dalam daftar pesan di antarmuka web Gmail.
labelListVisibility

enum (LabelListVisibility)

Visibilitas label dalam daftar label di antarmuka web Gmail.
type

enum (Type)

Jenis pemilik untuk label. Label pengguna dibuat oleh pengguna dan dapat diubah serta dihapus oleh pengguna dan dapat diterapkan pada pesan atau rangkaian pesan apa pun. Label sistem dibuat secara internal dan tidak dapat ditambahkan, diubah, atau dihapus. Label sistem mungkin dapat diterapkan ke atau dihapus dari pesan dan rangkaian pesan dalam kondisi tertentu, tetapi hal ini tidak dijamin. Misalnya, pengguna dapat menerapkan dan menghapus label INBOX dan UNREAD dari pesan dan rangkaian pesan, tetapi tidak dapat menerapkan atau menghapus label DRAFTS atau SENT dari pesan atau rangkaian pesan.
messagesTotal

integer

Jumlah total pesan dengan label.
messagesUnread

integer

Jumlah pesan yang belum dibaca dengan label.
threadsTotal

integer

Jumlah total rangkaian pesan dengan label.
threadsUnread

integer

Jumlah rangkaian pesan yang belum dibaca dengan label.
color

object (Color)

Warna yang akan ditetapkan ke label. Warna hanya tersedia untuk label yang menyetel type-nya ke user.

MessageListVisibility

Enumerasi
show Tampilkan label di daftar pesan.
hide Jangan tampilkan label di daftar pesan.

LabelListVisibility

Enumerasi
labelShow Tampilkan label di daftar label.
labelShowIfUnread Tampilkan label jika ada pesan yang belum dibaca dengan label tersebut.
labelHide Jangan tampilkan label di daftar label.

Jenis

Enumerasi
system Label yang dibuat oleh Gmail.
user Label khusus yang dibuat oleh pengguna atau aplikasi.

Warna

Representasi JSON 
{
  "textColor": string,
  "backgroundColor": string
}
Kolom
textColor

string

Warna teks label, yang direpresentasikan sebagai string heksadesimal. Kolom ini wajib diisi untuk menetapkan warna label. yang tersedia.
backgroundColor

string

Warna latar belakang ditampilkan sebagai string heksadesimal #RRGGBB (contoh #000000). Kolom ini wajib diisi untuk menetapkan warna label. yang tersedia.

Metode

create

 Membuat label baru.

delete

 Segera dan secara permanen menghapus label yang ditentukan dan menghapusnya dari pesan dan rangkaian pesan tempat label diterapkan.

get

 Mendapatkan label yang ditentukan.

list

 Mencantumkan semua label di kotak surat pengguna.

patch

 Patch label yang telah ditentukan.

update

 Memperbarui label yang ditentukan.