هناك طريقتان لإرسال الرسائل الإلكترونية باستخدام Gmail API:
- يمكنك إرسالها مباشرةً باستخدام
طريقة
messages.send
. - ويمكنك إرسالها من مسودة باستخدام طريقة
drafts.send
.
يتم إرسال الرسائل الإلكترونية كسلاسل بترميز base64url في السمة raw
لمورد رسالة. يتلخص سير العمل عالي
المستوى لإرسال بريد إلكتروني في:
- يمكنك إنشاء محتوى البريد الإلكتروني بطريقة سهلة وترميزه كسلسلة base64url.
- يمكنك إنشاء مورد رسائل جديد وضبط سمة
raw
الخاصة به على سلسلة base64url التي أنشأتها للتو. - يمكنك الاتصال بـ
messages.send
أوdrafts.send
لإرسال الرسالة في حال إرسال مسودّة.
يمكن أن تختلف تفاصيل سير العمل هذا حسب اختيارك لمكتبة العملاء ولغة البرمجة.
إنشاء الرسائل
تتطلب واجهة برمجة التطبيقات Gmail API الرسائل الإلكترونية بتنسيق MIME متوافقة مع RFC 2822 وترميزها كسلاسل base64url. تحتوي العديد من لغات البرمجة على مكتبات أو أدوات مساعدة تبسّط عملية إنشاء رسائل MIME وترميزها. توضّح أمثلة الرموز التالية كيفية إنشاء رسالة MIME باستخدام مكتبات عملاء Google APIs للغات المختلفة.
Java
يمكن تبسيط إنشاء رسالة إلكترونية إلى حد كبير باستخدام الفئة MimeMessage
في حزمة javax.mail.internet
. يوضح المثال التالي كيفية إنشاء
رسالة البريد الإلكتروني، بما في ذلك العناوين:
الخطوة التالية هي ترميز MimeMessage
وإنشاء مثيل لكائن Message
وضبط سلسلة الرسالة base64url كقيمة للسمة raw
.
Python
يوضِّح نموذج الرمز البرمجي التالي إنشاء رسالة MIME، وترميزها لسلسلة base64url، وتعيينها للحقل raw
في المورد Message
:
إنشاء رسائل تحتوي على مرفقات
إنّ إنشاء رسالة تتضمّن مرفقًا يشبه إنشاء أي رسالة أخرى، ولكن عملية تحميل الملف كرسالة MIME متعدّدة الأجزاء تعتمد على لغة البرمجة. توضِّح أمثلة الرمز البرمجي التالية الطرق الممكنة لإنشاء رسالة MIME متعدّدة الأجزاء باستخدام مرفق.
Java
يوضِّح المثال التالي كيفية إنشاء رسالة MIME متعدّدة الأجزاء، وتكون خطوات الترميز والإسناد هي نفسها الخطوات المذكورة أعلاه.
Python
على غرار المثال السابق، يعالج هذا المثال أيضًا ترميز الرسالة إلى base64url وتعيينها إلى الحقل raw
في المورد Message
.
إرسال الرسائل
بعد إنشاء رسالة، يمكنك إرسالها عن طريق إضافتها إلى نص الطلب ضمن المكالمة messages.send
، كما هو موضّح في الأمثلة التالية.
Java
Python
إذا كنت تحاول إرسال ردّ وتريد تضمين الرسالة الإلكترونية في سلسلة محادثات، تأكَّد مما يلي:
- العنوانان (
Subject
) مطابقان. - يتّبع العنوانان
References
وIn-Reply-To
معيار RFC 2822.
للحصول على معلومات حول إرسال رسالة من مسودة، راجِع إنشاء المسودات.