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 label yang tidak dapat diubah.

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 label. Label pengguna dibuat oleh pengguna dan dapat diubah serta dihapus oleh pengguna dan dapat diterapkan ke pesan atau rangkaian pesan apa pun. Label sistem dibuat secara internal dan tidak dapat ditambahkan, diubah, atau dihapus. Dalam situasi tertentu, label sistem mungkin dapat diterapkan ke atau dihapus dari pesan dan rangkaian pesan, 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 type-nya ditetapkan ke user.

MessageListVisibility

Enum
show Menampilkan label dalam daftar pesan.
hide Jangan tampilkan label di daftar pesan.

LabelListVisibility

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

Jenis

Enum
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, direpresentasikan sebagai string heksadesimal. Kolom ini wajib diisi untuk menetapkan warna label. #4f80 #65999 #659C#F2C#F2C#F3799 #66FDF9 #66FDF9 #4D49C #49C#F399 #66C#F2C#F2C#F2C#FD999 #66FDF9 #66FDF9e #4599 #48C#F2C#F2C#FD999 #666666 #999999 #666666 #999999 #666666 #999999 #666666 #999999 #666666 #999999

backgroundColor

string

Warna latar belakang direpresentasikan sebagai string {i>hex<i} #RRGGBB (contoh #000000). Kolom ini wajib diisi untuk menetapkan warna label. #4f80 #65999 #659C#F2C#F2C#F3799 #66FDF9 #66FDF9 #4D49C #49C#F399 #66C#F2C#F2C#F2C#FD999 #66FDF9 #66FDF9e #4599 #48C#F2C#F2C#FD999 #666666 #999999 #666666 #999999 #666666 #999999 #666666 #999999 #666666 #999999

Metode

create

Membuat label baru.

delete

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

get

Mendapatkan label yang ditentukan.

list

Mencantumkan semua label di kotak surat pengguna.

patch

Menerapkan patch pada label yang ditentukan.

update

Memperbarui label yang ditentukan.