الأسئلة الشائعة حول إيقاف الروابط الديناميكية نهائيًا

أطلقنا "روابط Firebase الديناميكية" منذ أكثر من 7 سنوات لجعل عناوين URL أكثر فعالية، مثلاً، من خلال تغيير وجهة الرابط بشكل ديناميكي استنادًا إلى شروط وقت التشغيل.

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

على سبيل المثال، أثّرت التغييرات في المنظومة المتكاملة في قدرتنا على توفير تجربة مستقرة باستمرار لإحدى الميزات الأساسية في "الروابط الديناميكية من Firebase"، وهي منح مستخدمي التطبيق انتقالًا سلسًا إلى التطبيق بعد تثبيته، بغض النظر عن النظام الأساسي.

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

ندرك أنّ هذا التغيير سيتطلّب منك وقتًا لتقييم الحلول أو موفّري المنصات البديلة في السوق واعتمادها.

نواصل تطوير Firebase لتلبية احتياجاتك مع استمرار تطوّر المنظومة المتكاملة وتغيّرها. سنواصل إطلاق ميزات جديدة وتحديثات في جميع منتجات Firebase، ونلتزم بمساعدتك على التميّز في رحلات تطوير تطبيقاتك.

ما هي المعلومات التي يجب معرفتها؟

في 25 أغسطس 2025، سيتم إيقاف ميزة "روابط Firebase الديناميكية". ستتوقّف جميع الروابط التي تقدّمها "روابط Firebase الديناميكية" (المستضافة على نطاقات مخصّصة والنطاقات الفرعية page.link) عن العمل، ولن يعود بإمكانك إنشاء روابط جديدة.

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

سنواصل أيضًا تعديل هذا الدليل وإضافة المزيد من الأسئلة الشائعة إليه مع اقتراب موعد إيقاف الإصدار نهائيًا في 25 آب (أغسطس) 2025، وسنضيف أي مشاكل إضافية نكتشفها أثناء تقديم الدعم لك في جهود نقل البيانات.

راجِع الأسئلة الشائعة أدناه للحصول على إجابات عن بعض الأسئلة الأكثر أهمية.

لبدء عملية نقل البيانات، يُرجى الاطّلاع على الأسئلة الشائعة حول"كيف يمكنني نقل البيانات من الخدمة" أدناه.

في 25 أغسطس 2025، سيتم إيقاف ميزة "روابط Firebase الديناميكية". ستتوقف جميع الروابط التي تقدّمها "روابط Firebase الديناميكية" (سواء تلك المستضافة على نطاقات مخصّصة أو على نطاقات فرعية من page.link) عن العمل.

ما هي المدة الزمنية المتاحة لنقل البيانات؟

لديك حتى 25 أغسطس 2025 لإكمال عملية نقل البيانات.

نعم، ستستمر الروابط الجديدة والحالية في العمل إلى أن يتم إيقاف خدمة Dynamic Links نهائيًا في 25 أغسطس 2025.

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

عند إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا، يمكنك توقُّع ما يلي:

  • ستعرض جميع الروابط التي يتم النقر عليها رمز حالة HTTP 404 للمستخدمين النهائيين.
  • جميع طلبات HTTP إلى:

    • https://firebasedynamiclinks.googleapis.com/v1/shortLinks (Short Links API)
    • https://firebasedynamiclinks.googleapis.com/v1/SHORT_DYNAMIC_LINK/linkStats (Link Stats API)

    سيعرض رمز حالة HTTP ‏400 أو 403.

  • ستبدأ استجابات الخطأ المذكورة أعلاه تدريجيًا في 25 أغسطس 2025 إلى أن تصل في النهاية إلى معدّلات استجابة خطأ بنسبة% 100 بعد انقضاء تاريخ إيقاف الخدمة.

  • في ما يلي السلوك المستند إلى إصدار منصة حزمة SDK وطلب واجهة برمجة التطبيقات الذي تم إجراؤه في تطبيقك:

    iOS

    حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟
    إنشاء رابط مختصر

    shorten (Swift)

    shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    403 يتم عرض الخطأ مع سبب المشكلة لا*
    الإحالة الناجحة عند فتح التطبيق لأول مرة

    يتم استدعاء هذه الطريقة تلقائيًا عند استدعاء FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

    400 لا يتم عرض أي أخطاء، ولكن يتم إرسال عنصر FDL مع بيانات فارغة. لا*
    تحديد مصدر إعادة فتح التطبيق

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    400 يتم عرض الخطأ مع سبب المشكلة لا*

    Android

    حالة الاستخدام طلب بيانات من واجهة برمجة التطبيقات رمز الحالة السلوك هل سيتعطّل تطبيقك؟
    إنشاء رابط مختصر

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    403 يتم عرض الخطأ مع سبب المشكلة لا*
    الإحالة الناجحة عند فتح التطبيق لأول مرة

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 تعرض المهمة استجابة ناجحة، ولكن ستكون بيانات FDL فارغة لا*
    تحديد مصدر إعادة فتح التطبيق

    getDynamicLink(getIntent()) (Kotlin)

    getDynamicLink(getIntent()) (Java)

    400 تعرض المهمة استجابة ناجحة، ولكن ستكون بيانات FDL فارغة لا*
    قبول الدعوة يتم استدعاء وحدة AppInvite في "خدمات Google Play" عند التعامل مع عملية إعادة توجيه الغرض (من ‎ *.page.link أو نطاق مخصّص) 400 تعرض هذه السمة مؤشر تحميل عند استدعاء "خدمات Google Play"، ويختفي عند تلقّي الردّ 400 لا*

كيف يمكنني نقل البيانات من الخدمة؟

لقد تبيّن لنا أنّ المطوّرين المختلفين لديهم احتياجات مختلفة عندما يتعلق الأمر باستخدام "روابط Firebase الديناميكية".

بناءً على حالات الاستخدام الخاصة بك وتقييم استخدامك لـ "الروابط الديناميكية من Firebase"، من المحتمل أن يتطابق أحد السيناريوهات أدناه مع احتياجاتك.

في هذا السيناريو، ننصحك باستخدام مقدّمي خدمات / مورّدي روابط الصفحات العميقة الآخرين، مثل Adjust وAirbridge وAppsFlyer وBitly وBranch وKochava وSingular وغيرهم من مقدّمي الخدمات المشابهين في السوق. (يُرجى العِلم أنّ Google لم تتحقّق من هؤلاء المقدّمين، ولكنّهم يوفّرون وظائف مشابهة لوظائف "روابط Firebase الديناميكية").

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

للمساعدة في العثور على مقدّم خدمة يتضمّن ميزات مطابقة لميزات "روابط Firebase الديناميكية"، يُرجى الرجوع إلى قائمة الميزات التالية أدناه.

ميزات "روابط Firebase الديناميكية":

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

ماذا لو كنت مهتمًا فقط بالربط بصفحات في تطبيقي بعد تثبيته؟

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

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

يوضّح هذا الدليل أيضًا كيفية استخدام خدمة "استضافة Firebase" بشكل اختياري لاستضافة الملفات اللازمة للتحقّق من النطاق وروابط مواد العرض على النطاق الذي تخطّط لاستخدامه في روابطك الجديدة (مثل ملف assetlinks.json لروابط التطبيق، وملف apple-app-site-association للروابط العامة).

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

  • مراجعة "روابط Firebase الديناميكية" الحالية باتّباع الدليل حول تصدير البيانات الوصفية للروابط للتأكّد من عدم تأثّر المستخدمين والتطبيق عند التوقّف عن عرض الروابط

  • حذف بادئات عناوين URL الخاصة بـ "روابط Firebase الديناميكية" في وحدة تحكّم Firebase ملاحظة: سيتم تلقائيًا حذف نطاقات بادئة عنوان URL بعد 25 أغسطس 2025.

  • إزالة حزمة تطوير البرامج (SDK) لخدمة "روابط Firebase الديناميكية" من تطبيقاتك

إذا ظهرت لك حالة نقل بيانات لا تغطّي احتياجاتك، يُرجى التواصل معنا لإعلامنا بذلك.

ستظلّ واجهات برمجة التطبيقات الخاصة بالروابط القصيرة والإحصاءات في "روابط Firebase الديناميكية" متاحةً حتى تاريخ إيقافها نهائيًا في 25 أغسطس 2025.

وبعد هذا التاريخ، لن تعود واجهات برمجة التطبيقات هذه متاحة للاستخدام، وسيتم إيقاف الخدمة.

يُرجى الرجوع إلى دليل تصدير البيانات الوصفية للروابط للحصول على تعليمات حول كيفية تصدير البيانات الوصفية للروابط.

يمكنك استخدام دليل التصدير لاسترداد البيانات الوصفية لـ "روابط Firebase الديناميكية"، والتي تتضمّن الرابط نفسه.

يمكنك استخدام Firebase Dynamic Links Analytics API لاسترداد بيانات إحصاءات الروابط لكل رابط من روابط Firebase الديناميكية. تقتصر واجهة برمجة التطبيقات هذه في "إحصاءات Google" على حوالي 5 طلبات في الثانية. للحصول على مثال حول كيفية العمل ضمن حد الطلب هذا عند استخدام واجهة برمجة التطبيقات، يُرجى الرجوع إلى نموذج Cloud Task هذا.

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

إذا كنت بحاجة إلى معدّل طلبات أعلى للمساعدة في عملية نقل البيانات، يُرجى التواصل معنا عبر فريق دعم Firebase.

سيتم وضع علامة الحذف على نطاقك وبياناتك الوصفية الخاصة بالروابط في 25 آب (أغسطس) 2025، وسيتم إزالتها نهائيًا وفقًا لسياسة الاحتفاظ بالبيانات.

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

يمكنك الاطّلاع على القائمة الكاملة بالإجراءات المتأثّرة بهذا التغيير.

ستستمر ميزة المصادقة باستخدام رابط يتم إرساله عبر البريد الإلكتروني وإجراءات البريد الإلكتروني خارج النطاق مع Firebase في العمل، ولكن عليك الترقية إلى أحدث إصدار من Firebase Authenticationحِزم تطوير البرامج (SDK) ونقل البيانات إلى الحلّ الجديد لمواصلة استخدام هذه الإجراءات بعد إيقاف خدمة Firebase Dynamic Links نهائيًا في 25 أغسطس 2025.

يمكنك اتّباع الأدلة المرتبطة أدناه للحصول على تعليمات حول كيفية إكمال عملية نقل البيانات:

يمكنك الاطّلاع على قائمة كاملة بالإجراءات المتأثّرة بهذا التغيير.

كيف تتأثّر عمليات تنفيذ مسار OAuth باستخدام إصدارات حزمة تطوير البرامج (SDK) لخدمة "المصادقة عبر Firebase" على Android الأقدم من الإصدار 20.0.0 أو إصدارات BoM الأقدم من الإصدار 26.0.0؟

عليك تحديث حزمة تطوير البرامج (SDK) لنظام التشغيل Android الخاصة بخدمة "المصادقة عبر Firebase" إلى أحدث إصدار (الإصدار 20.0.0 على الأقل) لمواصلة استخدام عملية OAuth في تطبيقات Android.

هل تتأثّر إجراءات البريد الإلكتروني في Firebase Authentication على تطبيقات الويب؟

لا، لأنّ إيقاف ميزة "روابط Firebase الديناميكية" نهائيًا يؤثّر فقط في معالجة عناوين URL الواردة على الأجهزة الجوّالة.

كيف تتأثر عمليات التنفيذ التي تستخدم مكتبات Firebase JS SDK لمصادقة موفّري OAuth في تطبيق Cordova؟

تستخدم حزمة تطوير البرامج (SDK) الخاصة بلغة JavaScript في Firebase روابط Firebase الديناميكية لتنفيذ عمليات مصادقة OAuth في تطبيقات Cordova. عليك تعديل عملية تنفيذك للخطوات من خلال تنفيذ خطوات OAuth يدويًا وتمرير بيانات اعتماد OAuth الناتجة إلى Firebase لإكمال عملية المصادقة.

اطّلِع على دليل Cordova لمزيد من التفاصيل.

يُرجى الاطّلاع على الأسئلة الشائعة حول "كيف يمكنني نقل البيانات من الخدمة" التي توضّح سيناريوهات مختلفة لنقل البيانات وتقدّم أدلة نقل البيانات للبدائل المختلفة المتاحة.