حالة النجاح في إجراءات البريد الإلكتروني

يمكنك تمرير الحالة عبر عنوان URL للمتابعة عند إرسال إجراءات البريد الإلكتروني للحصول على كلمة المرور. إعادة تعيين البريد الإلكتروني للمستخدم أو التحقق منه. يوفر هذا للمستخدم القدرة على والعودة إلى التطبيق بعد اكتمال الإجراء. بالإضافة إلى ذلك، يمكنك تحديد ما إذا كان سيتم التعامل مع رابط إجراء البريد الإلكتروني مباشرةً من تطبيق الأجهزة الجوّالة أم لا إذا تم تثبيته بدلاً من استخدام صفحة ويب.

قد يكون هذا مفيدًا للغاية في السيناريوهات الشائعة التالية:

• قد يحاول مستخدم، غير مسجِّل الدخول حاليًا، الوصول إلى محتوى يجب أن يسجّل المستخدم الدخول. ومع ذلك، ربما نسي المستخدم كلمة مروره، وبالتالي تبدأ عملية إعادة تعيين كلمة المرور. في نهاية المطاف، التدفق، يتوقع المستخدم العودة إلى قسم التطبيق الذي محاولة الوصول إليه.

• لا يجوز أن يوفّر أحد التطبيقات سوى إمكانية الوصول إلى الحسابات التي تم التحقّق منها. بالنسبة مثلاً، قد تطلب النشرة الإخبارية من المستخدم إثبات ملكية بريده الإلكتروني قبل الاشتراك. يمر المستخدم بخطوات إثبات ملكية عنوان البريد الإلكتروني ويتوقع للعودة إلى التطبيق لإكمال الاشتراك

• في حالات أخرى، قد يكون المستخدم قد بدأ التدفق من جهازه المحمول ويتوقعون بعد التحقق العودة إلى تطبيق الأجهزة الجوّالة بدلاً من المتصفح.

إنّ إمكانية تمرير الحالة عبر عنوان URL للمتابعة هي ميزة فعّالة. توفِّر مصادقة Firebase ويمكن أن تحسِّن تجربة المستخدم بشكل كبير.

حالة التمرير/متابعة عنوان URL في إجراءات البريد الإلكتروني

لتمرير عنوان URL للمتابعة بشكل آمن، يجب أن يكون نطاق عنوان URL هو أن تتم إضافته كنطاق مفوَّض في وحدة تحكُّم Firebase. يتم ذلك في قسم المصادقة من خلال إضافة هذا النطاق إلى قائمة بالنطاقات المسموح بها ضمن علامة التبويب طريقة تسجيل الدخول إذا لم تكن مُدرَجة من قبل.

يجب تقديم نسخة افتراضية من firebase.auth.ActionCodeSettings عند الإرسال رسالة بريد إلكتروني لإعادة تعيين كلمة المرور أو رسالة تأكيد. تأخذ هذه الواجهة المَعلمات التالية:

المعلمة	النوع	الوصف
url	السلسلة	لضبط الرابط (عنوان URL للحالة/المتابعة) الذي يحمل معانٍ مختلفة في سياقات مختلفة: عند معالجة الرابط في أدوات إجراءات الويب، فإن هذا هو الموضع في معلَمة طلب البحث continueUrl. عند التعامل مع الرابط في التطبيق مباشرةً، هذا هو معلَمة طلب البحث "continueUrl" في الرابط لصفحة في التطبيق الرابط الديناميكي.
iOS	({bundleId: string}|غير محدَّدة)	لضبط معرّف حزمة iOS. سيحاول هذا فتح الرابط في تطبيق iOS في حال تم تثبيته. يجب تسجيل تطبيق iOS في Console.
android	({packageName: string, installApp:منطقي|غير محدّدة، الحد الأدنى من الإصدارات: سلسلة|غير محددة}|غير محدّد)	لضبط اسم حزمة Android. سيؤدي هذا الإجراء إلى فتح الرابط في تطبيق Android إذا كان مثبتًا. إذا تم تجاوز installApp، سيتم يحدد ما إذا كان سيتم تثبيت تطبيق Android إذا كان الجهاز يتوافق معه التَّطْبِيقْ دَهْ مِشْ مِتْثَبِّتْ بِالْفِعْلْ. إذا تم توفير هذا الحقل بدون packageName، تم حدوث خطأ لتوضيح أنّ يجب توفير packageName بالتزامن مع هذا الحقل. إذا تم تحديد minimumVersion، وتم تحديد إصدار قديم من إذا تم تثبيت التطبيق، يتم نقل المستخدم إلى "متجر Play" لترقية التطبيق. يجب تسجيل تطبيق Android في Console.
handleCodeInApp	(منطقي|غير محدّدة)	ما إذا كان رابط إجراء البريد الإلكتروني سيتم فتحه في تطبيق للأجهزة الجوّالة أو على الويب أولاً. وتكون القيمة التلقائية false. وعند ضبطها على "صحيح"، يعمل رابط رمز الإجراء سيتم إرساله كرابط عام أو رابط تطبيق Android وسيتم فتحه. بواسطة التطبيق إذا كان مثبّتًا. في الحالة الخاطئة، سيتم إرسال الرمز إلى تطبيق الويب المصغّر أولاً ثم المتابعة، ستتم إعادة التوجيه إلى التطبيق في حال مثبت.
dynamicLinkDomain	(سلسلة|غير محدّدة)	تضبط نطاق الرابط الديناميكي (أو النطاق الفرعي) لاستخدامه مع الرابط الحالي. إذا كان سيتم فتحه باستخدام روابط Firebase الديناميكية. كديناميكي متعدد يمكن ضبط نطاقات الروابط لكل مشروع، ويوفر هذا الحقل والقدرة على اختيار واحدة بشكل صريح. إذا لم يتم تقديم أي اسم، يتم تحديد النطاق الأول يُستخدم بشكل افتراضي.

يوضح المثال التالي كيفية إرسال رابط التحقق من عنوان البريد الإلكتروني والذي في تطبيق للأجهزة الجوّالة أولاً كرابط ديناميكي بمنصة Firebase باستخدام نطاق الرابط الديناميكي example.page.link (تطبيق iOS com.example.ios أو تطبيق Android com.example.android حيث يكون التطبيق سيتم تثبيته إذا لم يكن مثبتًا من قبل والحد الأدنى للإصدار هو 12). تشير رسالة الأشكال البيانية رابط لصفحة في التطبيق سيحتوي على حمولة عنوان URL للمتابعة https://www.example.com/?email=user@example.com

var actionCodeSettings = {
  url: 'https://www.example.com/?email=' + firebase.auth().currentUser.email,
  iOS: {
    bundleId: 'com.example.ios'
  },
  android: {
    packageName: 'com.example.android',
    installApp: true,
    minimumVersion: '12'
  },
  handleCodeInApp: true,
  // When multiple custom dynamic link domains are defined, specify which
  // one to use.
  dynamicLinkDomain: "example.page.link"
};
firebase.auth().currentUser.sendEmailVerification(actionCodeSettings)
  .then(function() {
    // Verification email sent.
  })
  .catch(function(error) {
    // Error occurred. Inspect error.code.
  });

إعداد روابط Firebase الديناميكية

تستخدم مصادقة Firebase روابط Firebase الديناميكية عند إرسال رابطًا يُفترَض أن يتم فتحه في تطبيق الأجهزة الجوّالة. من أجل استخدام هذه هذه الميزة، يجب إعداد الروابط الديناميكية في "وحدة تحكُّم Firebase".

1. تفعيل روابط Firebase الديناميكية:

   1. في وحدة تحكّم Firebase، افتح القسم Dynamic Links.

   2. في حال عدم قبولك بنود "Dynamic Links" بعد وإنشاء Dynamic Links مجالك، قم بذلك الآن.

      إذا سبق لك إنشاء نطاق Dynamic Links، يُرجى تدوينه. Dynamic Links على النحو التالي:

      example.page.link

      ستحتاج إلى هذه القيمة عند ضبط تطبيق Apple أو Android على لاعتراض الرابط الوارد.

2. تهيئة تطبيقات Android:

   1. إذا كنت تريد التعامل مع هذه الروابط من تطبيق Android، يجب تحديد اسم حزمة Android في وحدة تحكُّم Firebase. إعدادات المشروع. بالإضافة إلى ذلك، SHA-1 وSHA-256 للتطبيق الشهادة اللازمة.
   2. ستحتاج أيضًا إلى ضبط فلتر الأهداف للرابط لصفحة معيّنة في ملف AndroidManifest.xml.
   3. لمزيد من المعلومات، راجع تلقّي تعليمات بشأن ميزة "الروابط الديناميكية على Android"

3. تهيئة تطبيقات iOS:

   1. إذا كنت تخطط للتعامل مع هذه الروابط من تطبيق iOS، يجب تحديد معرّف حزمة iOS في وحدة تحكُّم Firebase. إعدادات المشروع. بالإضافة إلى ذلك، إنّ معرّف App Store وApple Developer يجب أيضًا تحديد رقم تعريف الفريق.
   2. ستحتاج أيضًا إلى ضبط نطاق الرابط العام لـ FDL على أنّه النطاق المرتبط في إمكانات تطبيقك.
   3. إذا كنت تريد توزيع تطبيقك على الإصدار 8 من نظام التشغيل iOS والإصدارات الأقدم، عليك ضبط معرّف حزمة iOS كمخطط مخصّص للطلبات الواردة. عناوين URL.
   4. لمزيد من المعلومات، راجع تلقّي تعليمات بشأن الروابط الديناميكية لنظام التشغيل iOS

التعامل مع إجراءات البريد الإلكتروني في تطبيق ويب

يمكنك تحديد ما إذا كنت تريد معالجة رابط رمز الإجراء من موقع إلكتروني. التطبيق أولاً ثم إعادة التوجيه إلى صفحة ويب أو تطبيق للأجهزة الجوّالة آخر بعد الإكمال بنجاح، بشرط أن يكون تطبيق الأجهزة الجوّالة متاحًا. يتم ذلك من خلال ضبط handleCodeInApp على false في كائن firebase.auth.ActionCodeSettings. في حين أن معرِّف حزمة iOS أو اسم حزمة Android، فسيتيح تقديمه للمستخدمين لإعادة التوجيه إلى التطبيق المحدّد عند إكمال رمز إجراء البريد الإلكتروني

عنوان URL للويب المستخدَم هنا هو العنوان الذي تم إعداده في نماذج الإجراءات عبر البريد الإلكتروني . يتم توفير نموذج تلقائي لجميع المشاريع. ارجع إلى تخصيص معالِجات البريد الإلكتروني لمعرفة المزيد حول كيفية تخصيص معالج إجراء البريد الإلكتروني.

في هذه الحالة، سيكون الرابط ضمن معلَمة طلب البحث continueUrl رابط FDL الذي تكون حمولةته هي URL المحدّد في ActionCodeSettings الخاص بك. يمكنك اعتراض الرابط الوارد من تطبيقك والتعامل معه. بدون أي تبعية إضافية، ننصحك باستخدام مكتبة برامج FDL رابط الموضع المعيّن لك.

عند التعامل مع إجراءات البريد الإلكتروني مثل التحقق من البريد الإلكتروني، يتم عرض رمز الإجراء من يجب تحليل معلَمة طلب البحث "oobCode" من الرابط لصفحة في التطبيق، ثم تطبيقها. عبر applyActionCode لكي يسري التغيير، أي البريد الإلكتروني المطلوب التحقق منه.

التعامل مع إجراءات البريد الإلكتروني في تطبيق للأجهزة الجوّالة

يمكنك تحديد ما إذا كنت تريد معالجة رابط رمز الإجراء في تطبيق الهاتف المحمول أولاً، بشرط أن يكون مثبتًا. باستخدام تطبيقات Android، ويمكنك أيضًا أن تحدّد عبر android.installApp أنّ التطبيق أن يتم تثبيته إذا كان الجهاز يتيح استخدامه ولم يكن مثبّتًا. إذا تم النقر على الرابط من جهاز لا يعمل مع الجوّال تطبيقًا، يتم فتحه من صفحة ويب بدلاً من ذلك. يتم ذلك من خلال ضبط handleCodeInApp على true في كائن firebase.auth.ActionCodeSettings. يظهر تطبيق الهاتف المحمول كما يجب أيضًا تحديد اسم حزمة Android أو معرّف حزمة iOS.

عنوان URL الاحتياطي المستخدم هنا، عندما لا يتوفر أي تطبيق للأجهزة الجوّالة، هو العنوان في قسم نماذج إجراءات البريد الإلكتروني. يتم توفير حساب تلقائي لجميع المشروعات. ارجع إلى تخصيص معالِجات البريد الإلكتروني لمعرفة المزيد حول كيفية تخصيص معالج إجراء البريد الإلكتروني.

في هذه الحالة، سيكون رابط تطبيق الأجهزة الجوّالة الذي يتم إرساله إلى المستخدم رابط FDL هو عنوان URL لرمز الإجراء، والذي تمت تهيئته في وحدة التحكم، مع طلب المَعلمات oobCode وmode وapiKey وcontinueUrl سيكون الموضع الأخير قيمة URL الأصلية المحددة في الكائن ActionCodeSettings. وعلى الرغم من أنّه يمكنك اعتراض الروابط الواردة من تطبيقك والتعامل معها بدون أي إجراءات إضافية ننصحك باستخدام مكتبة برامج FDL لتحليل الرابط الخاص بموضع معيّن يناسبك ذلك. يمكن تطبيق رمز الإجراء مباشرةً من تطبيق للأجهزة الجوّالة مشابه على كيفية التعامل معه من تدفق الويب الموضح في تخصيص معالِجات البريد الإلكتروني.

عند التعامل مع إجراءات البريد الإلكتروني مثل التحقق من البريد الإلكتروني، يتم عرض رمز الإجراء من يجب تحليل معلَمة طلب البحث "oobCode" من الرابط لصفحة في التطبيق، ثم تطبيقها. عبر applyActionCode لكي يسري التغيير، أي البريد الإلكتروني المطلوب التحقق منه.