يوضّح هذا المستند كيفية ضبط إعدادات إعادة توجيه الرسائل الإلكترونية في Gmail API.
يمكنك استخدام مصدر
settings لضبط إعدادات إعادة التوجيه لأحد الحسابات. لاستخدام عنوان بريد إلكتروني كعنوان بريد إلكتروني لإعادة التوجيه، يجب أن يستوفي أحد المعايير التالية:
- تمّ التحقّق من عنوان البريد الإلكتروني. لمزيد من المعلومات، يُرجى الاطّلاع على المقالة إنشاء عناوين إعادة التوجيه وتأكيدها.
- ينتمي عنوان البريد الإلكتروني إلى النطاق نفسه الذي ينتمي إليه المُرسِل.
- ينتمي عنوان البريد الإلكتروني إلى نطاق فرعي ضمن النطاق نفسه الذي ينتمي إليه المُرسِل.
- ينتمي عنوان البريد الإلكتروني إلى اسم نطاق مستعار تم ضبطه كجزء من حساب Google Workspace نفسه.
إذا لم يستوفِ عنوان البريد الإلكتروني لإعادة التوجيه إحدى هذه القواعد، ستفشل عملية إعداد إعادة التوجيه باستخدام واجهة برمجة التطبيقات.
لمعرفة كيفية
إنشاء،
عرض،
الحصول على،
أو
حذف
عناوين إعادة التوجيه، يُرجى الاطّلاع على الطرق في
settings.forwardingAddresses
المصدر.
لمعرفة كيفية
الحصول على
أو
تعديل
إعدادات إعادة التوجيه التلقائي، يُرجى الاطّلاع على الطرق في مصدر
settings.
إنشاء عناوين إعادة التوجيه وتأكيدها
يجب إنشاء عناوين إعادة التوجيه قبل استخدامها. في بعض الحالات، يجب على المستخدمين أيضًا تأكيد ملكية العنوان.
إذا طلبت Gmail من المستخدم تأكيد عنوان إعادة التوجيه، يتم عرض العنوان مع
VerificationStatus
بقيمة pending. ويتم تلقائيًا إرسال رسالة تأكيد إلى عنوان البريد الإلكتروني الوجهة. على مالك عنوان البريد الإلكتروني إكمال عملية التأكيد قبل أن يتمكّن من استخدامه.
تكون حالة التأكيد لعناوين إعادة التوجيه التي لا تتطلّب التأكيد هي accepted.
تفعيل إعادة التوجيه التلقائي
يمكنك اختيار إعادة توجيه جميع رسائلك الجديدة إلى عنوان بريد إلكتروني آخر.
لإجراء ذلك، اتّصِل بطريقة
updateAutoForwarding
لتفعيل إعادة التوجيه التلقائي لأحد الحسابات. يتطلّب الاتصال عنوان إعادة توجيه مسجّلاً ومؤكّدًا وإجراءً يتم اتخاذه بشأن الرسائل المعاد توجيهها.
يتم ضبط هذه الإعدادات باستخدام عنصر
AutoForwarding.
يُستخدَم الحقل
disposition
لضبط حالة الرسالة بعد إعادة توجيهها. القيمة التلقائية هي dispositionUnspecified، ولكن لا يمكنك ضبط هذا الحقل على dispositionUnspecified.
تعرض عيّنات التعليمات البرمجية التالية كيفية تفعيل إعادة التوجيه التلقائي ثم نقل الرسائل المعاد توجيهها إلى المهملات:
جافا
Python
لإيقاف إعادة التوجيه التلقائي، اتّصِل بطريقة updateAutoForwarding واضبط
enabled
الحقل في عنصر AutoForwarding على false.
إعادة توجيه رسائل معيّنة
تعيد ميزة إعادة التوجيه التلقائي توجيه جميع رسائل Gmail المستلَمة إلى الحساب الوجهة. لإعادة توجيه رسائل معيّنة، يمكنك إعداد فلتر لإنشاء قواعد تعيد توجيه الرسائل استجابةً لسمات الرسالة أو محتواها.
لإعادة توجيه الرسائل إلى حسابات متعددة، يمكنك إنشاء فلتر لكل عنوان بريد إلكتروني مُعاد توجيهه.