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

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

https://example.page.link/WXYZ

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

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

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

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

Firebase Dynamic Links 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 खोले, तो उसे ऐप्लिकेशन के सही सेक्शन पर भेजा जा सके.

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

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