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