يوضّح هذا المستند كيفية طلب البحث عن الرسائل والعثور عليها باستخدام Gmail API.
يمكنك البحث عن الملفات أو فلترتها باستخدام الطريقتَين
messages.list
وthreads.list. تقبل هذه الطرق مَعلمة الطلب q التي تتوافق مع معظم بنية البحث المتقدّم نفسها المتوافقة مع واجهة الويب في Gmail. للاطّلاع على قائمة بالاختلافات بين واجهة مستخدم Gmail وGmail API في ما يتعلق بالبحث والفلترة، يُرجى الاطّلاع على الاختلافات عن واجهة مستخدم Gmail.
تتيح لك بنية البحث المتقدّم هذه استخدام طلبات بحث لفلترة الرسائل حسب خصائص، مثل المرسِل أو التاريخ أو التصنيف. على سبيل المثال، يسترد استعلام طريقة messages.list التالي جميع الرسائل التي أرسلها المستخدم في كانون الثاني (يناير) 2014:
GET https://www.googleapis.com/gmail/v1/users/me/messages?q=in:sent after:2014/01/01 before:2014/02/01
بالإضافة إلى طلبات البحث، يمكنك أيضًا فلترة الرسائل وسلاسل المحادثات حسب التصنيف باستخدام المَعلمة labelIds[]. يتيح لك ذلك البحث عن الرسائل وسلاسل المحادثات التي تم تطبيق التصنيفات المحددة الخاصة بالنظام أو المستخدم عليها. لمزيد من المعلومات، اطّلِع على الطريقتَين
messages.list وthreads.list. لمزيد من المعلومات حول التصنيفات، يُرجى الاطّلاع على مقالة إدارة التصنيفات.
الاختلافات عن واجهة مستخدم Gmail
مع أنّ Gmail API يتوافق مع معظم صيغة البحث المتقدّم المستخدَمة في واجهة مستخدم Gmail، هناك بعض الاختلافات:
تنفّذ واجهة مستخدم Gmail عملية توسيع الاسم المستعار، ما يسمح لها باستنتاج عنوان بديل للبريد الإلكتروني للحساب من حساب Google Workspace. على سبيل المثال، لنفترض أنّ لديك حسابًا بعنوان
myprimary@cymbalgroup.comوأنّ المشرف أعدّ اسمًا مستعارًا لهذا الحساب وهوmyalias@cymbalgroup.com. إذا أرسلmyalias@cymbalgroup.comرسالة إلكترونية، ولكنك بحثت عن "from: myprimary@cymbalgroup.com"، ستظهر الرسالة الإلكترونية التي أرسلهاmyalias@cymbalgroup.comفي نتائج البحث في واجهة مستخدم Gmail، ولكن لن تظهر في استجابة واجهة برمجة التطبيقات.تتيح واجهة مستخدم Gmail للمستخدمين إجراء عمليات بحث على مستوى سلسلة المحادثات، ولكن لا تتيح واجهة برمجة التطبيقات ذلك.