Catch up on highlights from Firebase at Google I/O 2023. Learn more

आरईएसटी एपीआई के साथ गतिशील लिंक बनाएं

आप फायरबेस डायनामिक लिंक रेस्ट एपीआई के साथ छोटे डायनेमिक लिंक बना सकते हैं। यह एपीआई या तो एक लंबे डायनेमिक लिंक या डायनेमिक लिंक पैरामीटर वाले ऑब्जेक्ट को स्वीकार करता है, और निम्न उदाहरण की तरह एक यूआरएल देता है:

https://example.page.link/WXYZ

एपीआई और क्लाइंट (एंड्रॉइड/एप्पल) एसडीके के साथ बनाए गए लघु गतिशील लिंक फायरबेस कंसोल में दिखाई नहीं देते हैं। इस तरह के डायनामिक लिंक उपयोगकर्ता से उपयोगकर्ता साझा करने के लिए अभिप्रेत हैं। मार्केटिंग उपयोग के मामलों के लिए, Firebase कंसोल के डायनेमिक लिंक पेज के माध्यम से सीधे अपने लिंक बनाना जारी रखें।

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

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

    यदि आपके पास पहले से डायनेमिक लिंक डोमेन है, तो इसका ध्यान रखें। जब आप प्रोग्रामेटिक रूप से डायनेमिक लिंक बनाते हैं तो आपको डायनेमिक लिंक डोमेन प्रदान करने की आवश्यकता होती है।

लंबे डायनामिक लिंक को छोटा करने के लिए आप फायरबेस डायनेमिक लिंक एपीआई का उपयोग कर सकते हैं। ऐसा करने के लिए, longDynamicLink पैरामीटर में लंबे डायनेमिक लिंक को निर्दिष्ट करते हुए shortLinks एंडपॉइंट के लिए HTTP POST अनुरोध करें। उदाहरण के लिए:

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

लंबे डायनामिक लिंक बनाने का तरीका जानने के लिए मैन्युअल रूप से URL बनाएं देखें।

आप डायनेमिक लिंक मापदंडों को सीधे निर्दिष्ट करके एक छोटा डायनेमिक लिंक भी बना सकते हैं। ऐसा करने के लिए, dynamicLinkInfo पैरामीटर में डायनामिक लिंक पैरामीटर निर्दिष्ट करते हुए, shortLinks एंडपॉइंट के लिए एक HTTP पोस्ट अनुरोध करें। उदाहरण के लिए:

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

इस तरह के तार बेस 62-एन्कोडिंग द्वारा यादृच्छिक रूप से उत्पन्न 96-बिट संख्या द्वारा बनाए जाते हैं। अपने डायनामिक लिंक URL को अनुमान लगाने और क्रॉल होने से रोकने के लिए इस सेटिंग का उपयोग करें, जो संभावित रूप से संवेदनशील जानकारी को अनपेक्षित प्राप्तकर्ताओं के लिए उजागर कर सकता है।

यदि आप पैरामीटर को "SHORT" पर सेट करते हैं, तो पथ घटक एक स्ट्रिंग होगा जो केवल 4 वर्णों की न्यूनतम लंबाई के साथ अद्वितीय होने के लिए आवश्यक है।

https://example.page.link/WXYZ

इस विधि का उपयोग करें यदि एक छोटे डायनेमिक लिंक URL का अनुमान लगाने पर संवेदनशील जानकारी उजागर नहीं होगी।

निम्न उदाहरण दिखाता है कि आप 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:// योजनाओं से शुरू होना चाहिए। यह कंसोल में दर्ज किए गए किसी भी URL पैटर्न श्वेतसूची से भी मेल खाना चाहिए। अन्यथा, HTTP त्रुटि कोड 400 के साथ निर्माण API विफल हो जाएगा।

अगले कदम

अब जब आपने डायनेमिक लिंक बना लिए हैं, तो आपको डायनेमिक लिंक प्राप्त करने के लिए अपना ऐप सेट करना होगा और उपयोगकर्ता द्वारा उन्हें खोलने के बाद उपयोगकर्ताओं को अपने ऐप में सही जगह पर भेजना होगा।

अपने ऐप में डायनामिक लिंक प्राप्त करने के लिए, iOS , Android , C++ , और Unity के लिए दस्तावेज़ीकरण देखें।

अनुरोध 5 अनुरोध/आईपी पता/सेकंड और 200,000 अनुरोध/दिन तक सीमित हैं। यदि इससे अधिक हो जाता है, तो प्रतिक्रिया HTTP त्रुटि कोड 429 वापस कर देगी। अधिक कोटा के लिए अनुरोध करने के लिए, इस फॉर्म को भरें।