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

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

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

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

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

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

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

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

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

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

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

يمكنك الاطّلاع على الأسئلة الشائعة أدناه للمساعدة في الإجابة عن بعض أهم أسئلتك.

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

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

كم من الوقت لدي لنقل البيانات؟

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

نعم، ستستمر الروابط الجديدة والحالية في العمل إلى أن يتم إيقاف خدمة "الروابط الديناميكية" في 25 آب (أغسطس) 2025.

عند إيقاف ميزة "روابط 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.

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

    iOS

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

    shorten (Swift)

    ‫shortenUrl (Swift)

    shortenWithCompletion (Objective-C)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*
    تحديد مصدر الفتح الأول

    يتمّ استدعاؤه تلقائيًا عند FirebaseApp.configure (Swift) / FIRApp.configure (Objective-C)

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

    handleUniversalLink (Swift)

    handleUniversalLink (Objective-C)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*

    Android

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

    buildShortDynamicLink (Kotlin)

    buildShortDynamicLink (Java)

    		 400 يتم بث الخطأ مع سبب الخطأ لا*
    تحديد مصدر الفتح الأول

    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 وغيرهم من الموفّري/ المورّدين المشابهين في السوق. (يُرجى العِلم أنّ Google لم تفحص هذه الخدمات، ولكنّها توفّر وظائف مشابهة لـ "روابط Firebase الديناميكية").

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

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

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

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

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

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

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

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

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

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

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

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

إذا رأيت سيناريو نقل بيانات لا يلبي احتياجاتك، يُرجى التواصل معنا لإعلامنا بذلك.

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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