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