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

เอกสารนี้อธิบายวิธีจัดการป้ายกำกับในเธรดและข้อความโดยใช้ Gmail API

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

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

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

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

ป้ายกำกับมี 2 ประเภท ได้แก่ ป้ายกำกับที่สงวนไว้ SYSTEM และป้ายกำกับที่กำหนดเอง USER

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

ชื่อ ใช้ได้ด้วยตนเอง หมายเหตุ
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