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

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

https://example.page.link/WXYZ

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

قبل البدء

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

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

إنشاء فيديو Shorts Dynamic Link

إنشاء رابط قصير من رابط طويل

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

إنشاء رابط مختصر من المَعلمات

يمكنك أيضًا إنشاء فيديو Shorts 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 لتحديد طريقة إنشاء مكوّن المسار الخاص بعنوان URL المختصَر 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 طلب/يوم. في حال تجاوز الحدّ، سيعرض الردّ رمز الخطأ 429 في بروتوكول نقل الروابط النصية (HTTP). لطلب حصة أكبر، يُرجى ملء هذا النموذج.