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

يمكنك إنشاء روابط قصيرة Dynamic Links باستخدام واجهة REST API لخدمة "روابط Firebase الديناميكية". تقبل واجهة برمجة التطبيقات هذه إما 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. دوِّن قيمة الحقل مفتاح واجهة برمجة التطبيقات على الويب.
  2. في وحدة تحكّم Firebase، افتح القسم Dynamic Links.

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

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

يمكنك استخدام واجهة برمجة التطبيقات "روابط Firebase الديناميكية" لاختصار 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 طويل.

يمكنك أيضًا إنشاء عنوان URL مختصر 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

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

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

https://example.page.link/WXYZ

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

يوضّح المثال التالي كيفية ضبط المَعلمة 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.

لتلقّي Dynamic Links في تطبيقك، راجِع المستندات الخاصة بـ iOS وAndroid وC++‎ وUnity.

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