إنشاء روابط ديناميكية باستخدام واجهة برمجة تطبيقات REST

يمكنك إنشاء Dynamic Links قصيرة باستخدام واجهة برمجة التطبيقات REST API لخدمة "روابط Firebase الديناميكية". تقبل واجهة برمجة التطبيقات هذهDynamic Link طويلة أو عنصرًا يحتوي على مَعلمات Dynamic Link، وDynamic Linkتعرض عنوان URL مثل المثال التالي:

https://example.page.link/WXYZ

لا تظهر فيديوهات Dynamic Links القصيرة التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات وحزمة تطوير البرامج (SDK) للعميل (Android/Apple) في وحدة تحكّم Firebase. هذه Dynamic Links مخصّصة للمشاركة بين المستخدمين. بالنسبة إلى حالات الاستخدام التسويقية، يُرجى مواصلة إنشاء الروابط مباشرةً من خلال صفحة Dynamic Links في وحدة تحكّم Firebase.

قبل البدء

  1. احصل على مفتاح واجهة برمجة التطبيقات. ستحتاج إلى مفتاح واجهة برمجة التطبيقات لمصادقة طلباتك المرسَلة إلى واجهة برمجة التطبيقات. للعثور على مفتاح واجهة برمجة التطبيقات:
    1. افتح صفحة الإعدادات في وحدة تحكّم Firebase. إذا طُلب منك اختيار مشروع، اختَر مشروعك على Firebase من القائمة.
    2. دوِّن قيمة حقل مفتاح Web API.
  2. في وحدة تحكّم Firebase، افتح قسم Dynamic Links.

  3. إذا لم يسبق لك قبول بنود الخدمة وإعداد نطاق لحسابك على Dynamic Links، يُرجى إجراء ذلك عندما يُطلب منك ذلك.

    إذا كان لديك نطاق Dynamic Links، دوِّنه. عليك تقديم نطاق Dynamic Links عند إنشاء Dynamic Links آليًا.

يمكنك استخدام واجهة برمجة التطبيقات Firebase Dynamic Links API لتقصير Dynamic Link طويل. لإجراء ذلك، قدِّم طلب HTTP POST إلى نقطة النهاية shortLinks، مع تحديد Dynamic Link الطويل في المَعلمة longDynamicLink. على سبيل المثال:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=https://www.example.com/&apn=com.example.android&ibi=com.example.ios"
}

اطّلِع على مقالة إنشاء عنوان URL يدويًا للتعرّف على كيفية إنشاء Dynamic Links طويل.

يمكنك أيضًا إنشاء Dynamic Link قصير من خلال تحديد مَعلمات Dynamic Link مباشرةً. لإجراء ذلك، أرسِل طلب HTTP POST إلى نقطة نهاية shortLinks ، مع تحديد مَعلمات Dynamic Link في المَعلمة dynamicLinkInfo. على سبيل المثال:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
  "dynamicLinkInfo": {
    "domainUriPrefix": "https://example.page.link",
    "link": "https://www.example.com/",
    "androidInfo": {
      "androidPackageName": "com.example.android"
    },
    "iosInfo": {
      "iosBundleId": "com.example.ios"
    }
  }
}

للاطّلاع على مواصفات كاملة للكائن dynamicLinkInfo، يُرجى الاطّلاع على مرجع واجهة برمجة التطبيقات.

ضبط مدة فيديو Shorts Dynamic Link

يمكنك أيضًا ضبط المَعلمة suffix لتحديد كيفية إنشاء عنصر المسار في Dynamic Link القصير.

بشكلٍ تلقائي، أو إذا ضبطت المَعلمة على "UNGUESSABLE"، سيكون مكوّن المسار سلسلة من 17 حرفًا، كما هو موضّح في المثال التالي:

https://example.page.link/UVWXYZuvwxyz12345

يتم إنشاء هذه السلاسل من خلال ترميز أرقام 96 بت يتم إنشاؤها عشوائيًا باستخدام قاعدة 62. استخدِم هذا الإعداد لمنع تخمين عناوين URL الخاصة بموقعك الإلكتروني على Dynamic Links والزحف إليها، لأنّ ذلك قد يؤدي إلى تعريض معلومات حساسة للمستلمين غير المقصودين.

في حال ضبط المَعلمة على "SHORT"، سيكون مكوّن المسار سلسلة لن تتعدى طولها الحدّ الأدنى البالغ 4 أحرف، وذلك لتكون فريدة.

https://example.page.link/WXYZ

استخدِم هذه الطريقة إذا لم تكن المعلومات الحسّاسة ستظهر في حال تخمين Dynamic Link عنوان URL قصير.

يوضّح المثال التالي كيفية ضبط المَعلمة suffix:

POST https://firebasedynamiclinks.googleapis.com/v1/shortLinks?key=api_key
Content-Type: application/json

{
   "longDynamicLink": "https://example.page.link/?link=http://www.example.com/&apn=com.example.android&ibi=com.example.ios",
   "suffix": {
     "option": "UNGUESSABLE"
   }
}

يجب أن تبدأ قيمة الرابط لصفحة في التطبيق المقدَّمة على الأقل بأحد المخططَين http:// أو https://. ويجب أن يتطابق أيضًا مع أيّ قائمة بيضاء لأنماط عناوين URL تم إدخالها في وحدة التحكّم. بخلاف ذلك، ستتعذّر واجهة برمجة التطبيقات لإنشاء الحملة مع ظهور رمز خطأ HTTP‏ 400.

الخطوات التالية

بعد إنشاء Dynamic Links، عليك إعداد تطبيقك لتلقّي Dynamic Links وإرسال المستخدمين إلى المكان المناسب في تطبيقك بعد فتحه.

لتلقّي Dynamic Links في تطبيقك، اطّلِع على مستندات iOS وAndroid و C++ وUnity.

تقتصر الطلبات على 5 طلبات لكل عنوان IP في الثانية و200,000 طلب في اليوم. وفي حال تجاوز هذا الحدّ، سيعرض الردّ رمز الخطأ 429 في HTTP. لطلب زيادة الحصة، يُرجى ملء هذا النموذج.