المورد: الفلتر
تعريف المورد لفلاتر Gmail. تنطبق الفلاتر على رسائل محددة بدلاً من سلسلة محادثات كاملة عبر البريد الإلكتروني.
تمثيل JSON |
---|
{ "id": string, "criteria": { object ( |
الحقول | |
---|---|
id |
الخادم الذي خصّص معرّف الفلتر. |
criteria |
معايير المطابقة للفلتر. |
action |
الإجراء الذي ينفذه الفلتر. |
المعايير
معايير مطابقة الرسائل.
تمثيل JSON |
---|
{
"from": string,
"to": string,
"subject": string,
"query": string,
"negatedQuery": string,
"hasAttachment": boolean,
"excludeChats": boolean,
"size": integer,
"sizeComparison": enum ( |
الحقول | |
---|---|
from |
الاسم المعروض للمُرسِل أو عنوان بريده الإلكتروني. |
to |
اسم العرض للمستلم أو عنوان بريده الإلكتروني. ويتضمن ذلك المستلمين في حقول العناوين "إلى"، و"نسخة إلى"، و"نسخة مخفية الوجهة". يمكنك ببساطة استخدام الجزء المحلي من عنوان البريد الإلكتروني. على سبيل المثال، يتطابق "example" و"example@" مع "example@gmail.com". هذا الحقل غير حساس لحالة الأحرف. |
subject |
تم العثور على عبارة غير حساسة لحالة الأحرف في موضوع الرسالة. يتم اقتطاع المسافة اللاحقة والمسافة البادئة الأولى ويتم تصغير المساحات المجاورة. |
query |
عدم عرض سوى الرسائل المطابقة لطلب البحث المحدد. يتيح استخدام نفس تنسيق الاستعلام كمربع بحث Gmail. مثلاً: |
negatedQuery |
لا تعرض سوى الرسائل التي لا تتطابق مع طلب البحث المحدد. يتيح استخدام نفس تنسيق الاستعلام كمربع بحث Gmail. مثلاً: |
hasAttachment |
ما إذا كانت الرسالة تحتوي على أي مرفقات. |
excludeChats |
لتحديد ما إذا كان يجب أن تستبعد الاستجابة المحادثات أم لا. |
size |
حجم رسالة RFC822 بالبايت بالكامل، بما في ذلك جميع العناوين والمرفقات. |
sizeComparison |
كيف ينبغي أن يكون حجم الرسالة بالبايت بالنسبة إلى حقل الحجم؟ |
مقارنة الحجم
لتحديد كيفية مقارنة حقل الحجم بحجم الرسالة.
عمليات التعداد | |
---|---|
unspecified |
|
smaller |
للعثور على الرسائل الأصغر من الحجم المحدد. |
larger |
للعثور على الرسائل التي يزيد حجمها عن الحجم المحدّد |
الإجراء
مجموعة من الإجراءات لتنفيذها على رسالة.
تمثيل JSON |
---|
{ "addLabelIds": [ string ], "removeLabelIds": [ string ], "forward": string } |
الحقول | |
---|---|
addLabelIds[] |
قائمة بالتصنيفات المراد إضافتها إلى الرسالة. |
removeLabelIds[] |
قائمة التصنيفات التي ستتم إزالتها من الرسالة. |
forward |
عنوان البريد الإلكتروني الذي ستتم إعادة توجيه الرسالة إليه. |
الطُرق |
|
---|---|
|
لإنشاء فلتر. |
|
لحذف الفلتر المحدّد على الفور وبشكل نهائي. |
|
للحصول على فلتر |
|
يدرج فلاتر الرسائل لمستخدم Gmail. |