REST API ile Dinamik Bağlantılar Oluşturun

Firebase Dynamic Links REST API ile kısa Dinamik Bağlantılar oluşturabilirsiniz. Bu API, uzun bir Dinamik Bağlantıyı veya Dinamik Bağlantı parametrelerini içeren bir nesneyi kabul eder ve aşağıdaki örneğe benzer bir URL döndürür:

https://example.page.link/WXYZ

API ve istemci (Android/Apple) SDK'sıyla oluşturulan Kısa Dinamik Bağlantılar Firebase konsolunda görünmüyor. Bu tür Dinamik Bağlantılar, kullanıcıdan kullanıcıya paylaşıma yöneliktir. Pazarlama amaçlı kullanım örnekleri için bağlantılarınızı doğrudan Firebase konsolunun Dinamik Bağlantılar sayfasından oluşturmaya devam edin.

Sen başlamadan önce

  1. API anahtarınızı alın. API'ye yönelik isteklerinizi doğrulamak için bir API anahtarına ihtiyacınız olacak. API anahtarınızı bulmak için:
    1. Firebase konsolunun Ayarlar sayfasını açın. Bir proje seçmeniz istenirse menüden Firebase projenizi seçin.
    2. Web API Anahtarı alanının değerini not edin.
  2. Firebase konsolunda Dinamik Bağlantılar bölümünü açın.
  3. Hizmet şartlarını henüz kabul etmediyseniz ve Dinamik Bağlantılarınız için bir alan adı belirlemediyseniz istendiğinde bunu yapın.

    Zaten bir Dinamik Bağlantılar alanınız varsa bunu not edin. Programlı olarak Dinamik Bağlantılar oluşturduğunuzda bir Dinamik Bağlantılar alanı sağlamanız gerekir.

Uzun bir Dinamik Bağlantıyı kısaltmak için Firebase Dynamic Links API'yi kullanabilirsiniz. Bunu yapmak için longDynamicLink parametresinde uzun Dinamik Bağlantıyı belirterek shortLinks uç noktasına bir HTTP POST isteği yapın. Örneğin:

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

Uzun Dinamik Bağlantıların nasıl oluşturulacağını öğrenmek için URL'yi manuel olarak oluşturma konusuna bakın.

Doğrudan Dinamik Bağlantı parametrelerini belirterek de kısa bir Dinamik Bağlantı oluşturabilirsiniz. Bunu yapmak için, dynamicLinkInfo parametresinde Dinamik Bağlantı parametrelerini belirterek shortLinks uç noktasına bir HTTP POST isteği yapın. Örneğin:

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 nesnesinin tam özellikleri için API referansına bakın.

Kısa Dinamik Bağlantının uzunluğunu ayarlama

Kısa Dinamik Bağlantının yol bileşeninin nasıl oluşturulduğunu belirtmek için suffix parametresini de ayarlayabilirsiniz.

Varsayılan olarak veya parametreyi "UNGUESSABLE" olarak ayarlarsanız, yol bileşeni aşağıdaki örnekte olduğu gibi 17 karakterlik bir dize olacaktır:

https://example.page.link/UVWXYZuvwxyz12345

Bu tür dizeler, rastgele oluşturulmuş 96 bitlik sayıların base62 kodlamasıyla oluşturulur. Dinamik Bağlantı URL'lerinizin tahmin edilmesini ve taranmasını önlemek için bu ayarı kullanın; bu durum, hassas bilgilerin istenmeyen alıcıların eline geçmesine neden olabilir.

Parametreyi "SHORT" olarak ayarlarsanız, yol bileşeni yalnızca benzersiz olması gereken uzunlukta ve minimum 4 karakter uzunluğunda bir dize olacaktır.

https://example.page.link/WXYZ

Kısa bir Dinamik Bağlantı URL'si tahmin edildiğinde hassas bilgilerin açığa çıkmayacağı durumlarda bu yöntemi kullanın.

Aşağıdaki örnek, suffix parametresini nasıl ayarlayabileceğinizi gösterir:

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

Sağlanan derin bağlantı değeri en azından http:// veya https:// şemalarıyla başlamalıdır. Ayrıca konsola girilen tüm URL kalıpları beyaz listesiyle de eşleşmelidir. Aksi takdirde, oluşturma API'si HTTP hata kodu 400 ile başarısız olur.

Sonraki adımlar

Artık Dinamik Bağlantılar oluşturduğunuza göre, uygulamanızı Dinamik Bağlantıları alacak ve kullanıcı bunları açtıktan sonra kullanıcıları uygulamanızda doğru yere gönderecek şekilde ayarlamanız gerekir.

Uygulamanızda Dinamik Bağlantılar almak için iOS , Android , C++ ve Unity belgelerine bakın.

İstekler 5 istek/IP adresi/saniye ve 200.000 istek/gün ile sınırlıdır. Aşılırsa yanıtta 429 HTTP hata kodu döndürülür. Daha fazla kota istemek için bu formu doldurun.