REST Resource: users.settings.filters

แหล่งข้อมูล: ตัวกรอง

คำจำกัดความทรัพยากรสำหรับตัวกรอง Gmail ตัวกรองจะมีผลกับข้อความที่ต้องการแทนที่จะเป็นชุดข้อความอีเมลทั้งหมด

การแสดง JSON
{
  "id": string,
  "criteria": {
    object (Criteria)
  },
  "action": {
    object (Action)
  }
}
ช่อง
id

string

รหัสที่เซิร์ฟเวอร์กำหนดของตัวกรอง

criteria

object (Criteria)

เกณฑ์การจับคู่ของตัวกรอง

action

object (Action)

การดำเนินการที่ตัวกรองดำเนินการ

เกณฑ์

เกณฑ์การจับคู่ข้อความ

การแสดง JSON
{
  "from": string,
  "to": string,
  "subject": string,
  "query": string,
  "negatedQuery": string,
  "hasAttachment": boolean,
  "excludeChats": boolean,
  "size": integer,
  "sizeComparison": enum (SizeComparison)
}
ช่อง
from

string

ชื่อที่แสดงหรืออีเมลของผู้ส่ง

to

string

ชื่อที่แสดงหรืออีเมลของผู้รับ รวมผู้รับใน "ถึง" "สำเนา" และ "สำเนาลับ" ส่วนหัว คุณสามารถใช้แค่ส่วนท้องถิ่นของที่อยู่อีเมล เช่น "ตัวอย่าง" และ "example@" ทั้งคู่ตรงกับ "example@gmail.com" ช่องนี้ไม่คำนึงถึงตัวพิมพ์เล็กหรือใหญ่

subject

string

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

query

string

แสดงเฉพาะข้อความที่ตรงกับการค้นหาที่ระบุ รองรับการค้นหารูปแบบเดียวกับช่องค้นหาของ Gmail เช่น "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread"

negatedQuery

string

แสดงเฉพาะข้อความที่ไม่ตรงกับการค้นหาที่ระบุ รองรับการค้นหารูปแบบเดียวกับช่องค้นหาของ Gmail เช่น "from:someuser@example.com rfc822msgid:<somemsgid@example.com> is:unread"

hasAttachment

boolean

ข้อความมีไฟล์แนบหรือไม่

excludeChats

boolean

ระบุว่าการตอบกลับควรไม่รวมแชทหรือไม่

size

integer

ขนาดของข้อความ RFC822 ทั้งหมดในหน่วยไบต์ รวมถึงส่วนหัวและไฟล์แนบทั้งหมด

sizeComparison

enum (SizeComparison)

ขนาดข้อความในหน่วยไบต์ควรสัมพันธ์กับช่องขนาดอย่างไร

SizeComparison

กำหนดว่าควรเปรียบเทียบช่องขนาดกับขนาดข้อความอย่างไร

Enum
unspecified
smaller ค้นหาข้อความที่เล็กกว่าขนาดที่ระบุ
larger ค้นหาข้อความที่มีขนาดใหญ่กว่าขนาดที่ระบุ

การดำเนินการ

ชุดการดำเนินการที่จะดำเนินการกับข้อความ

การแสดง JSON
{
  "addLabelIds": [
    string
  ],
  "removeLabelIds": [
    string
  ],
  "forward": string
}
ช่อง
addLabelIds[]

string

รายการป้ายกำกับที่จะเพิ่มในข้อความ

removeLabelIds[]

string

รายการป้ายกำกับที่จะนำออกจากข้อความ

forward

string

อีเมลที่ควรส่งต่อข้อความ

เมธอด

create

สร้างตัวกรอง

delete

ลบตัวกรองที่ระบุทันทีและอย่างถาวร

get

รับตัวกรอง

list

แสดงตัวกรองข้อความของผู้ใช้ Gmail