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

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

https://example.page.link/WXYZ

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

قبل ان تبدأ

  1. احصل على مفتاح API الخاص بك. ستحتاج إلى مفتاح واجهة برمجة التطبيقات (API) لمصادقة طلباتك إلى واجهة برمجة التطبيقات (API). للعثور على مفتاح API الخاص بك:
    1. افتح صفحة الإعدادات في وحدة تحكم Firebase. إذا طُلب منك اختيار مشروع، فحدد مشروع Firebase الخاص بك من القائمة.
    2. لاحظ قيمة حقل Web API Key .
  2. في وحدة تحكم Firebase، افتح قسم الروابط الديناميكية .
  3. إذا لم تكن قد قبلت بالفعل شروط الخدمة وقمت بتعيين مجال للارتباطات الديناميكية الخاصة بك، فقم بذلك عندما يُطلب منك ذلك.

    إذا كان لديك بالفعل مجال الارتباطات الديناميكية، فلاحظ ذلك. يتعين عليك توفير مجال الارتباطات الديناميكية عند إنشاء الارتباطات الديناميكية برمجيًا.

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

يمكنك أيضًا إنشاء رابط ديناميكي قصير عن طريق تحديد معلمات الارتباط الديناميكي مباشرة. للقيام بذلك، قم بإجراء طلب HTTP POST إلى نقطة نهاية shortLinks ، مع تحديد معلمات الارتباط الديناميكي في معلمة 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 ، راجع مرجع API .

قم بتعيين طول الارتباط الديناميكي القصير

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

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

https://example.page.link/UVWXYZuvwxyz12345

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

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

https://example.page.link/WXYZ

استخدم هذه الطريقة إذا لم يتم الكشف عن المعلومات الحساسة إذا تم تخمين عنوان 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.

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

الآن بعد أن قمت بإنشاء الارتباطات الديناميكية، تحتاج إلى إعداد تطبيقك لتلقي الارتباطات الديناميكية وإرسال المستخدمين إلى المكان الصحيح في تطبيقك بعد أن يفتحهم المستخدم.

لتلقي الروابط الديناميكية في تطبيقك، راجع وثائق iOS و Android و C++ و Unity .

تقتصر الطلبات على 5 طلبات/عنوان IP/الثانية، و200000 طلب/اليوم. إذا تم تجاوزها، فسوف ترجع الاستجابة رمز خطأ HTTP 429. لطلب المزيد من الحصص، املأ هذا النموذج .