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

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

https://example.page.link/WXYZ

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

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

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

  3. अगर आपने पहले से सेवा की शर्तें स्वीकार नहीं की हैं और अपने डाइनैमिक लिंक के लिए कोई डोमेन सेट किया है, तो निर्देश मिलने पर यह काम करें.

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

बड़े डाइनैमिक लिंक को छोटा करने के लिए, Firebase डाइनैमिक लिंक एपीआई का इस्तेमाल किया जा सकता है. ऐसा करने के लिए, 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"
}

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

सीधे डाइनैमिक लिंक पैरामीटर तय करके, छोटा डाइनैमिक लिंक भी बनाया जा सकता है. ऐसा करने के लिए, 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 ऑब्जेक्ट के बारे में पूरी जानकारी पाने के लिए, एपीआई का रेफ़रंस देखें.

छोटे डाइनैमिक लिंक की लंबाई सेट करना

suffix पैरामीटर को सेट करके, यह बताया जा सकता है कि छोटे डाइनैमिक लिंक का पाथ कॉम्पोनेंट कैसे जनरेट होता है.

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

https://example.page.link/UVWXYZuvwxyz12345

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

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

https://example.page.link/WXYZ

अगर डाइनैमिक लिंक के छोटे यूआरएल का अनुमान लगाने से संवेदनशील जानकारी ज़ाहिर नहीं होती, तो यह तरीका अपनाएं.

यहां दिए गए उदाहरण में, 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 दिखेगा.

अगले चरण

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

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

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