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

अगले चरण

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

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

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