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

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

    إذا كان لديك نطاق Dynamic Links، يُرجى تدوينه. عليك تقديم نطاق Dynamic Links عند إنشاء Dynamic Links آليًا.

يمكنك استخدام واجهة برمجة التطبيقات Firebase Dynamic Links لاختصار رابط 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 مباشرةً. لإجراء ذلك، أرسِل طلب POST HTTP إلى نقطة النهاية 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.

By default, or if you set the parameter to "UNGUESSABLE", the path component will be a 17-character string, such as in the following example:

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 تم إدخالها في وحدة التحكّم. وإلا، ستتعذّر واجهة برمجة التطبيقات الخاصة بالإنشاء مع ظهور رمز الخطأ 400 في بروتوكول HTTP.

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

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

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

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