REST API की मदद से डाइनैमिक लिंक बनाना

Firebase डाइनैमिक लिंक के REST API की मदद से, छोटे Dynamic Links बनाए जा सकते हैं. यह एपीआई, Dynamic Link या Dynamic Link पैरामीटर वाले ऑब्जेक्ट को स्वीकार करता है. साथ ही, यहां दिए गए उदाहरण की तरह यूआरएल दिखाता है:

https://example.page.link/WXYZ

एपीआई और क्लाइंट (Android/Apple) एसडीके की मदद से बनाए गए छोटे यूआरएल Dynamic Links, Firebase कंसोल में नहीं दिखते. इस तरह के Dynamic Links, उपयोगकर्ताओं के बीच शेयर करने के लिए होते हैं. मार्केटिंग के इस्तेमाल के उदाहरणों के लिए, Firebase कंसोल के Dynamic Links पेज से सीधे अपने लिंक बनाना जारी रखें.

शुरू करने से पहले

  1. अपना एपीआई पासकोड पाएं. एपीआई को भेजे जाने वाले अनुरोधों की पुष्टि करने के लिए, आपको एपीआई पासकोड की ज़रूरत होगी. अपना एपीआई पासकोड ढूंढने के लिए:
    1. Firebase कंसोल का सेटिंग पेज खोलें. अगर आपको कोई प्रोजेक्ट चुनने के लिए कहा जाए, तो मेन्यू से अपना Firebase प्रोजेक्ट चुनें.
    2. वेब एपीआई पासकोड फ़ील्ड की वैल्यू को नोट करें.
  2. Firebase कंसोल में, Dynamic Links सेक्शन खोलें.

  3. अगर आपने अब तक सेवा की शर्तें स्वीकार नहीं की हैं और अपने Dynamic Links के लिए कोई डोमेन सेट नहीं किया है, तो सूचना मिलने पर ऐसा करें.

    अगर आपके पास पहले से ही कोई Dynamic Links डोमेन है, तो उसे नोट कर लें. प्रोग्राम के हिसाब से Dynamic Links बनाते समय, आपको Dynamic Links डोमेन देना होगा.

Firebase डाइनैमिक लिंक API का इस्तेमाल करके, लंबे Dynamic Link को छोटा किया जा सकता है. ऐसा करने के लिए, shortLinks एंडपॉइंट पर एचटीटीपी पोस्ट अनुरोध करें. साथ ही, longDynamicLink पैरामीटर में लंबा Dynamic Link डालें. उदाहरण के लिए:

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"
}

मैन्युअल तरीके से यूआरएल बनाने का तरीका देखें, ताकि आप लंबे Dynamic Links बना सकें.

Dynamic Link पैरामीटर की जानकारी सीधे तौर पर देकर भी, छोटा Dynamic Link बनाया जा सकता है. ऐसा करने के लिए, shortLinks एंडपॉइंट पर एचटीटीपी पोस्ट अनुरोध करें. साथ ही, dynamicLinkInfo पैरामीटर में Dynamic Link पैरामीटर की जानकारी दें. उदाहरण के लिए:

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 ऑब्जेक्ट की पूरी जानकारी के लिए, एपीआई का संदर्भ देखें.

शॉर्ट वीडियो की अवधि सेट करना Dynamic Link

suffix पैरामीटर को भी सेट किया जा सकता है, ताकि यह तय किया जा सके कि छोटे Dynamic Link का पाथ कॉम्पोनेंट कैसे जनरेट होता है.

डिफ़ॉल्ट रूप से या पैरामीटर को "UNGUESSABLE" पर सेट करने पर, पाथ कॉम्पोनेंट 17 वर्णों की स्ट्रिंग होगी. जैसे, इस उदाहरण में:

https://example.page.link/UVWXYZuvwxyz12345

ऐसी स्ट्रिंग, किसी भी क्रम में जनरेट किए गए 96-बिट नंबर को base62-encoding करके बनाई जाती हैं. इस सेटिंग का इस्तेमाल करके, अपने Dynamic Links यूआरएल का अनुमान लगाने और उन्हें क्रॉल करने से रोकें. इससे संवेदनशील जानकारी को उन लोगों के साथ शेयर होने से बचाया जा सकता है जिनके साथ आपको जानकारी शेयर नहीं करनी है.

अगर पैरामीटर को "SHORT" पर सेट किया जाता है, तो पाथ कॉम्पोनेंट एक ऐसी स्ट्रिंग होगी जो यूनीक होने के लिए ज़रूरी लंबाई की होगी. इसमें कम से कम चार वर्ण होंगे.

https://example.page.link/WXYZ

इस तरीके का इस्तेमाल तब करें, जब छोटे 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:// स्कीम से शुरू होनी चाहिए. यह कंसोल में डाले गए, अनुमति वाले किसी भी यूआरएल पैटर्न से मेल खाना चाहिए. ऐसा न करने पर, क्रिएशन एपीआई काम नहीं करेगा और एचटीटीपी गड़बड़ी का कोड 400 दिखेगा.

अगले चरण

अब आपने Dynamic Links बना लिया है, तो आपको Dynamic Links पाने के लिए अपना ऐप्लिकेशन सेट अप करना होगा. साथ ही, उपयोगकर्ताओं को आपके ऐप्लिकेशन में सही जगह पर भेजना होगा.

अपने ऐप्लिकेशन में Dynamic Links पाने के लिए, iOS, Android, C++, और Unity के लिए दस्तावेज़ देखें.

अनुरोधों की संख्या, हर आईपी पते से हर सेकंड में पांच अनुरोध और हर दिन 2,00,000 अनुरोध तक सीमित है. अगर अनुरोधों की संख्या तय सीमा से ज़्यादा हो जाती है, तो जवाब में एचटीटीपी गड़बड़ी का कोड 429 दिखेगा.