จัดการป้ายกำกับ

คุณสามารถใช้ป้ายกำกับเพื่อติดแท็ก จัดระเบียบ รวมถึงจัดหมวดหมู่ข้อความและชุดข้อความใน Gmail ได้ ป้ายกำกับมีความสัมพันธ์แบบหลายต่อหลายข้อความกับข้อความและชุดข้อความ โดยคุณสามารถใช้ป้ายกำกับหลายป้ายกับข้อความหรือชุดข้อความเดียว และใช้ป้ายกำกับเดียวกับข้อความหรือชุดข้อความหลายรายการได้

ดูข้อมูลเกี่ยวกับวิธีสร้าง รับ รายการ อัปเดต หรือลบป้ายกำกับได้ที่ข้อมูลอ้างอิงเกี่ยวกับป้ายกำกับ

หากต้องการจัดการป้ายกำกับ คุณต้องใช้ขอบเขต https://www.googleapis.com/auth/gmail.labels ดูข้อมูลเพิ่มเติมเกี่ยวกับขอบเขตได้ที่ข้อมูลการให้สิทธิ์และการตรวจสอบสิทธิ์สำหรับ Gmail API โดยเฉพาะ

ประเภทของป้ายกำกับ

ป้ายกำกับมี 2 รูปแบบ ได้แก่ ป้ายกำกับ SYSTEM ที่สงวนไว้และป้ายกำกับ USER แบบกำหนดเอง โดยทั่วไปป้ายกำกับของระบบจะตรงกับองค์ประกอบที่กำหนดไว้ล่วงหน้าในอินเทอร์เฟซบนเว็บของ Gmail เช่น กล่องจดหมาย ชื่อป้ายกำกับของระบบเป็นชื่อที่สงวนไว้ คุณไม่สามารถสร้างป้ายกำกับ USER ที่มีชื่อเดียวกันกับป้ายกำกับ SYSTEM ใดๆ ได้ ตารางต่อไปนี้แสดงป้ายกำกับต่างๆ ของระบบ Gmail ที่พบบ่อยที่สุด

ชื่อ นำไปใช้ด้วยตนเองได้ Notes
INBOX ใช่
SPAM ใช่
TRASH ใช่
UNREAD ใช่
STARRED ใช่
IMPORTANT ใช่
SENT ไม่ ใช้โดยอัตโนมัติกับข้อความที่ส่งด้วย drafts.send หรือ messages.send โดยแทรกด้วย messages.insert และอีเมลของผู้ใช้ในส่วนหัว From หรือส่งโดยผู้ใช้ผ่านเว็บอินเทอร์เฟซ
DRAFT ไม่ มีผลกับข้อความ draft ทั้งหมดที่สร้างด้วย Gmail API หรืออินเทอร์เฟซ Gmail โดยอัตโนมัติ
CATEGORY_PERSONAL ใช่ ใช้กับข้อความที่แสดงในแท็บส่วนตัวของอินเทอร์เฟซ Gmail
CATEGORY_SOCIAL ใช่ ใช้กับข้อความที่แสดงในแท็บโซเชียลของอินเทอร์เฟซ Gmail
CATEGORY_PROMOTIONS ใช่ ใช้กับข้อความที่แสดงในแท็บโปรโมชันของอินเทอร์เฟซ Gmail
CATEGORY_UPDATES ใช่ ใช้กับข้อความที่แสดงในแท็บอัปเดตของอินเทอร์เฟซ Gmail
CATEGORY_FORUMS ใช่ ใช้กับข้อความที่แสดงในแท็บ "ฟอรัม" ของอินเทอร์เฟซ Gmail

จัดการป้ายกำกับในข้อความและชุดข้อความ

ป้ายกำกับจะมีอยู่บนข้อความเท่านั้น เช่น หากแสดงป้ายกำกับในชุดข้อความ คุณจะได้รับรายการป้ายกำกับที่อยู่ในข้อความภายในชุดข้อความ บางข้อความภายในชุดข้อความอาจไม่มีป้ายกำกับอยู่ คุณสามารถนำป้ายกำกับหลายป้ายไปใช้กับข้อความได้ แต่จะใช้ป้ายกำกับกับข้อความร่างไม่ได้

เพิ่มหรือนำป้ายกำกับออกจากชุดข้อความ

เมื่อเพิ่มหรือนำป้ายกำกับของชุดข้อความออก จะเป็นการเพิ่มหรือนำป้ายกำกับที่ระบุในข้อความที่มีอยู่ทั้งหมดในชุดข้อความออก

หากมีการเพิ่มข้อความในชุดข้อความหลังจากเพิ่มป้ายกำกับแล้ว ข้อความใหม่จะไม่รับค่าป้ายกำกับเดิมที่เชื่อมโยงกับชุดข้อความนั้น ถ้าต้องการเพิ่มป้ายกำกับในข้อความเหล่านั้น ก็ให้เพิ่มป้ายกำกับในชุดข้อความอีกครั้ง

หากต้องการเพิ่มหรือนำป้ายกำกับที่เชื่อมโยงกับชุดข้อความออก ให้ใช้ threads.modify

เพิ่มหรือนำป้ายกำกับออกจากข้อความ

เมื่อเพิ่มป้ายกำกับในข้อความ ระบบจะเพิ่มป้ายกำกับนั้นในข้อความนั้น และป้ายกำกับนั้นจะเชื่อมโยงกับชุดข้อความที่เป็นเจ้าของข้อความ ระบบจะไม่เพิ่มป้ายกำกับในข้อความอื่นๆ ภายในชุดข้อความ

หากคุณนำป้ายกำกับออกจากข้อความ และข้อความนั้นเป็นข้อความเดียวในชุดข้อความที่มีป้ายกำกับนั้น ป้ายกำกับจะถูกนำออกจากชุดข้อความด้วย

หากต้องการเพิ่มหรือนำป้ายกำกับที่ใช้กับข้อความออก ให้ใช้ messages.modify