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

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

https://example.page.link/WXYZ

لا تظهر فيديوهات Shorts التي تم إنشاؤها باستخدام واجهة برمجة التطبيقات وحزمة تطوير البرامج (SDK) الخاصة بالعميل (Android/Apple) في وحدة تحكّم Firebase.Dynamic Links تم تصميم 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 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

يتم إنشاء هذه السلاسل من خلال ترميز 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 في تطبيقك، راجِع المستندات الخاصة بـ iOS وAndroid وC++‎ وUnity.

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