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

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

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

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

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

ป้ายกำกับมี 2 ประเภท ได้แก่ ป้ายกำกับ SYSTEM ที่สงวนไว้และป้ายกำกับ USER ที่กําหนดเอง โดยปกติแล้วป้ายกำกับของระบบจะสอดคล้องกับองค์ประกอบที่กําหนดไว้ล่วงหน้าในเว็บอินเตอร์เฟซของ Gmail เช่น กล่องจดหมาย ระบบจะสงวนชื่อป้ายกำกับไว้ คุณจะสร้างป้ายกำกับ 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