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

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

https://example.page.link/WXYZ

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

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

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

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

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

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