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