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

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

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

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

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

  • بوجه عام، عندما يبدأ المستخدم عملية إعادة ضبط كلمة المرور أو إثبات ملكية عنوان البريد الإلكتروني على تطبيق Apple يتوقعون إكمال التدفق داخل التطبيق؛ القدرة على حالة التمرير عبر عنوان URL للمتابعة تجعل هذا ممكنًا.

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

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

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

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

المعلمة النوع الوصف
url سلسلة

لضبط الرابط (عنوان URL للحالة/المتابعة) الذي يحمل معانٍ مختلفة في سياقات مختلفة:

  • عند التعامل مع الرابط في أدوات إجراءات الويب، فإن هذا هو الموضع في معلَمة طلب البحث continueUrl.
  • عند التعامل مع الرابط في التطبيق مباشرةً، هذا هو معلَمة طلب البحث "continueUrl" في الرابط لصفحة في التطبيق الرابط الديناميكي.
iOSBundleId سلسلة لضبط معرّف الحزمة. سيؤدي هذا الإجراء إلى فتح الرابط في تطبيق Apple في حال تم تثبيته. يجب تسجيل التطبيق في Console. إذا كانت الإجابة "لا" تم توفير معرِّف الحزمة، وتم تعيين قيمة هذا الحقل على معرِّف الحزمة الحزمة الرئيسية للتطبيق.
androidPackageName سلسلة لضبط اسم حزمة Android. سيؤدي هذا الإجراء إلى فتح الرابط في Android إذا كان مثبتًا.
androidInstallApp قيمة منطقية (Bool) يحدِّد هذا الإعداد ما إذا كان سيتم تثبيت تطبيق Android إذا كان الجهاز متوافقًا معه. ولم يسبق لك تثبيت التطبيق. إذا تم توفير هذا الحقل بدون packageName، تم حدوث خطأ يوضح أنه يجب تحديد packageName المقدمة مع هذا الحقل.
androidMinimumVersion سلسلة تمثّل هذه السمة الحد الأدنى من إصدار التطبيق المتوافق في هذا المسار. في حال حذف تحديد الحد الأدنى للإصدار، وتم تثبيت إصدار قديم من التطبيق، يتم نقل المستخدم إلى متجر Play لترقية التطبيق. تطبيق Android أن يكون مسجَّلاً في Console
handleCodeInApp قيمة منطقية (Bool) ما إذا كان رابط إجراء البريد الإلكتروني سيتم فتحه في تطبيق للأجهزة الجوّالة أو على الويب أولاً. وتكون القيمة التلقائية 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

final user = FirebaseAuth.instance.currentUser;

final actionCodeSettings = ActionCodeSettings(
  url: "http://www.example.com/verify?email=${user?.email}",
  iOSBundleId: "com.example.ios",
  androidPackageName: "com.example.android",
);

await user?.sendEmailVerification(actionCodeSettings);

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

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

    1. في "وحدة تحكُّم Firebase"، افتح قسم الروابط الديناميكية.

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

    3. إذا سبق لك إنشاء نطاق "روابط ديناميكية"، دوِّنه. الروابط الديناميكية يبدو النطاق عادةً على النحو التالي: 

      example.page.link

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

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

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

  3. تكوين تطبيقات Apple:

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

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

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

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

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

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

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

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

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

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