ทรัพยากร: ป้ายกำกับ
ระบบจะใช้ป้ายกำกับเพื่อจัดหมวดหมู่ข้อความและชุดข้อความภายในกล่องจดหมายของผู้ใช้ จำนวนป้ายกำกับสูงสุดที่รองรับสำหรับกล่องจดหมายของผู้ใช้คือ 10,000 ป้าย
การแสดง JSON |
---|
{ "id": string, "name": string, "messageListVisibility": enum ( |
ช่อง | |
---|---|
id |
รหัสที่เปลี่ยนแปลงไม่ได้ของป้ายกำกับ |
name |
ชื่อที่แสดงของป้ายกำกับ |
messageListVisibility |
ระดับการมองเห็นข้อความที่มีป้ายกำกับนี้ในรายการข้อความในอินเทอร์เฟซบนเว็บของ Gmail |
labelListVisibility |
ระดับการเข้าถึงป้ายกำกับในรายการป้ายกำกับในอินเทอร์เฟซบนเว็บของ Gmail |
type |
ประเภทเจ้าของสำหรับป้ายกำกับ ป้ายกำกับของผู้ใช้เป็นผู้สร้างโดยผู้ใช้ ผู้ใช้จะแก้ไขและลบได้ และนำไปใช้กับข้อความหรือชุดข้อความใดก็ได้ ป้ายกำกับของระบบจะสร้างขึ้นเป็นการภายในและจะเพิ่ม แก้ไข หรือลบไม่ได้ คุณอาจนำป้ายกำกับระบบไปใช้กับหรือนำออกจากข้อความและชุดข้อความได้ในบางสถานการณ์ แต่การดำเนินการนี้ไม่รับประกันว่าจะทำได้ทุกครั้ง ตัวอย่างเช่น ผู้ใช้สามารถใช้และนำป้ายกำกับ |
messagesTotal |
จำนวนข้อความทั้งหมดที่มีป้ายกำกับ |
messagesUnread |
จำนวนข้อความที่ยังไม่อ่านที่มีป้ายกำกับ |
threadsTotal |
จำนวนชุดข้อความทั้งหมดที่มีป้ายกำกับ |
threadsUnread |
จำนวนชุดข้อความที่ยังไม่อ่านที่มีป้ายกำกับ |
color |
สีที่จะกำหนดให้กับป้ายกำกับ สีใช้ได้เฉพาะกับป้ายกำกับที่ตั้งค่า |
MessageListVisibility
Enum | |
---|---|
show |
แสดงป้ายกำกับในรายการข้อความ |
hide |
ไม่แสดงป้ายกำกับในรายการข้อความ |
LabelListVisibility
Enum | |
---|---|
labelShow |
แสดงป้ายกำกับในรายการป้ายกำกับ |
labelShowIfUnread |
แสดงป้ายกำกับหากมีข้อความที่ยังไม่อ่านซึ่งมีป้ายกำกับนั้น |
labelHide |
ไม่แสดงป้ายกำกับในรายการป้ายกำกับ |
ประเภท
Enum | |
---|---|
system |
ป้ายกำกับที่สร้างโดย Gmail |
user |
ป้ายที่กำหนดเองที่ผู้ใช้หรือแอปพลิเคชันสร้าง |
สี
การแสดง JSON |
---|
{ "textColor": string, "backgroundColor": string } |
ช่อง | |
---|---|
textColor |
สีข้อความของป้ายกำกับซึ่งแสดงเป็นสตริงเลขฐาน 16 ต้องกรอกข้อมูลในช่องนี้เพื่อตั้งค่าสีของป้ายกำกับ อนุญาตให้ใช้เฉพาะค่าสีค่าสีที่กำหนดไว้ล่วงหน้า |
backgroundColor |
สีพื้นหลังจะแสดงเป็นสตริงเลขฐาน 16 #RRGGBB (เช่น #000000) ต้องกรอกข้อมูลในช่องนี้เพื่อตั้งค่าสีของป้ายกำกับ อนุญาตให้ใช้เฉพาะค่าสีค่าสีที่กำหนดไว้ล่วงหน้า |
เมธอด |
|
---|---|
|
สร้างป้ายกำกับใหม่ |
|
ลบป้ายกำกับที่ระบุอย่างถาวรทันที รวมถึงนำออกจากข้อความและชุดข้อความที่ใช้ป้ายกำกับนั้นอยู่ |
|
รับป้ายกำกับที่ระบุ |
|
แสดงป้ายกำกับทั้งหมดในกล่องจดหมายของผู้ใช้ |
|
แพตช์ป้ายกำกับที่ระบุ |
|
อัปเดตป้ายกำกับที่ระบุ |