البحث عن الرسائل

يمكنك البحث عن الملفات أو فلترتها باستخدام الطريقتَين messages.list وthreads.list. تقبل هذه الطرق المعلَمة q التي تتوافق مع معظم بنية البحث المتقدم نفسها التي تكون فيها واجهة الويب في Gmail. للحصول على قائمة بالاختلافات في البحث والفلترة بين واجهة مستخدم Gmail وواجهة برمجة التطبيقات Gmail API، يُرجى الاطّلاع على الاختلافات في فلاتر البحث: واجهة مستخدم Gmail مقابل واجهة برمجة التطبيقات Gmail API.

تسمح لك هذه البنية المتقدمة باستخدام طلبات البحث لفلترة الرسائل حسب الخصائص مثل المُرسِل أو التاريخ أو التسمية، وذلك على سبيل القيام ببعض الاحتمالات. على سبيل المثال، يسترد طلب البحث التالي جميع الرسائل التي أرسلها المستخدم في يناير 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 توسيعًا للاسم المستعار، ما يسمح لها باستنتاج اسم مستعار للحساب من حساب Google Workspace. على سبيل المثال، لنفترض أنّ لديك حسابًا على myprimary@mycompany.net وأنّ المشرف أعدّ اسمًا مستعارًا لهذا الحساب الذي يخصّ myalias@mycompany.net. إذا أرسل myalias@mycompany.net رسالة إلكترونية، ولكنك بحثت عن "from: myprimary@mycompany.net)"، ستظهر الرسالة الإلكترونية المُرسَلة من myalias@mycompany.net كنتيجة بحث في واجهة مستخدم Gmail، ولكن ليس في استجابة واجهة برمجة التطبيقات.

  • تسمح واجهة مستخدم Gmail للمستخدمين بإجراء عمليات بحث على مستوى سلسلة المحادثات، على عكس واجهة برمجة التطبيقات.