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