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