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