Gmail API هي واجهة برمجة تطبيقات RESTful يمكن استخدامها للوصول إلى صناديق البريد في Gmail وإرسال الرسائل. بالنسبة إلى معظم تطبيقات الويب، تُعدّ واجهة Gmail API الخيار الأفضل للوصول المصرّح به إلى بيانات Gmail الخاصة بالمستخدم، وهي مناسبة لمختلف التطبيقات، مثل:
- استخراج الرسائل وفهرستها وإنشاء نسخة احتياطية منها للقراءة فقط
- إرسال الرسائل آليًا أو آليًا
- نقل حساب البريد الإلكتروني
- تنظيم الرسائل الإلكترونية، بما في ذلك فلترة الرسائل وترتيبها
- توحيد توقيعات الرسائل الإلكترونية في جميع أنحاء المؤسسة
عبارات عامة
في ما يلي قائمة بالمصطلحات الشائعة المستخدَمة في واجهة برمجة التطبيقات هذه:
- المفوِّض والمفوَّض إليه
- المفوِّض هو مستخدم Gmail يمنح مستخدمًا آخر إذن الوصول إلى صندوق البريد ضمن مؤسسة Google Workspace نفسها. المستخدم الذي يتلقّى إذن الوصول هذا هو المفوض. يمكن للمفوَّضين قراءة الرسائل وإرسالها وحذفها، بالإضافة إلى عرض جهات الاتصال وإضافتها نيابةً عن صاحب الحساب. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة المفوَّضين.
- مسودة
- رسالة لم يتم إرسالها يمكن استبدال رسالة مضمّنة في المسودة.
يؤدي إرسال مسودة إلى حذفها تلقائيًا وإنشاء رسالة تحمل تصنيف النظام
SENT. يتم تمثيل المسودة باستخدام الموردdrafts. لمزيد من المعلومات، يُرجى الاطّلاع على العمل باستخدام المسودات. - الفلاتر
- قواعد متقدّمة تم ضبطها لحساب يقيّم الرسائل الواردة بناءً على معايير مطابقة معيّنة (مثل المُرسِل أو الموضوع أو الحجم) عندما تتطابق رسالة مع أحد الفلاتر، يتم تلقائيًا تشغيل إجراءات مثل إضافة تصنيفات أو إزالتها، أو إعادة توجيه الرسالة الإلكترونية إلى عنوان محدّد. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الفلاتر.
- عناوين إعادة التوجيه
- عناوين بريد إلكتروني محدّدة تم إثبات ملكيتها وتم ضبطها لتلقّي الرسائل التي تتم إعادة توجيهها تلقائيًا من حساب أحد المستخدمين. قبل استخدام عنوان في قاعدة إعادة توجيه أو فلتر، يجب تسجيله رسميًا وإثبات ملكيته. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة إعادة التوجيه.
- التصنيف
آلية لتنظيم الرسائل وسلاسل المحادثات على سبيل المثال، يمكن إنشاء التصنيف "الضرائب" وتطبيقه على جميع الرسائل وسلاسل المحادثات المرتبطة بضرائب المستخدم. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة التصنيفات.
هناك نوعان من التصنيفات:
- تصنيفات النظام
- التصنيفات التي تم إنشاؤها داخليًا، مثل
INBOXأوTRASHأوSPAMلا يمكن حذف هذه التصنيفات أو تعديلها. ومع ذلك، يمكن تطبيق بعض تصنيفات النظام، مثلINBOX، على الرسائل وسلاسل المحادثات أو إزالتها منها. - تصنيفات المستخدمين
- التصنيفات التي أنشأها المستخدم يمكن للمستخدم أو أحد التطبيقات حذف هذه التصنيفات أو تعديلها. يتم تمثيل تصنيف المستخدم من خلال المورد
labels.
- رسالة
رسالة إلكترونية تحتوي على المُرسِل والمستلِمين والموضوع والنص الأساسي بعد إنشاء رسالة، لا يمكن تغييرها. يتم تمثيل الرسالة باستخدام المورد
messages.- الإشعارات الفورية
نظام إشعارات من جهة الخادم يتكامل مع Google Cloud Pub/Sub يمكن للتطبيقات "مراقبة" صندوق بريد إلكتروني، وسترسل Gmail API تلقائيًا ويب هوك أو تنبيهات عند حدوث أي تغيير (مثل وصول رسالة إلكترونية جديدة)، ما يغني التطبيق عن طلب البيانات من الخادم بشكل مستمر للحصول على آخر الأخبار. لمزيد من المعلومات، راجِع مقالة الإشعارات الفورية.
- شهادات S/MIME
الشهادات الرقمية التي يتم تحميلها إلى أسماء مستعارة محددة للإرسال باسم آخر، ما يتيح للمستخدم إرسال رسائل إلكترونية مشفَّرة وموقَّعة رقميًا، وبالتالي ضمان أمان الرسالة وأصالة المرسِل لمزيد من المعلومات، يُرجى الاطّلاع على إدارة شهادات S/MIME.
- عناوين البريد الإلكتروني البديلة الخاصة بميزة "الإرسال باسم"
تمثّل هذه الحقول عناوين البريد الإلكتروني المختلفة التي تم منح الحساب إذنًا بإرسال الرسائل منها. يتضمّن كل حساب عنوانًا بديلاً واحدًا على الأقل للبريد الإلكتروني يمثّل عنوان البريد الإلكتروني الرئيسي. تتطابق الأسماء المستعارة مع ميزة "إرسال الرسائل باسم" في واجهة Gmail على الويب، وهي أيضًا الأساس الذي يتم استخدامه لإعداد تواقيع البريد الإلكتروني لكل عنوان. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة الأسماء المستعارة.
- سلسلة المحادثات
مجموعة من الرسائل ذات الصلة تشكّل محادثة. في برنامج بريد إلكتروني، يتم إنشاء سلسلة محادثات عندما يردّ مستلم واحد أو أكثر على رسالة برسالة خاصة به. لمزيد من المعلومات، يُرجى الاطّلاع على إدارة سلاسل المحادثات.
مواضيع ذات صلة
للتعرّف على كيفية التطوير باستخدام واجهات برمجة التطبيقات في Google Workspace، بما في ذلك التعامل مع المصادقة والتفويض، يُرجى الرجوع إلى التطوير على Google Workspace.
لمعرفة كيفية ضبط تطبيق Gmail API وتشغيله، يُرجى قراءة البدايات السريعة.