REST API ile Dinamik Bağlantılar oluşturma

Firebase Dynamic Links REST API ile kısa Dynamic Links oluşturabilirsiniz. Bu API, uzun bir Dynamic Link veya Dynamic Link parametrelerini içeren bir nesne kabul eder ve aşağıdaki örnekte olduğu gibi bir URL döndürür:

https://example.page.link/WXYZ

API ve istemci (Android/Apple) SDK'sı ile oluşturulan kısa Dynamic Links, Firebase konsolunda gösterilmez. Bu tür Dynamic Links, kullanıcılar arasında paylaşım için tasarlanmıştır. Pazarlama kullanım alanları için bağlantılarınızı doğrudan Firebase Console'un Dynamic Links sayfasından oluşturmaya devam edin.

Başlamadan önce

  1. API anahtarınızı alın. API'ye gönderdiğiniz isteklerin kimliğini doğrulamak için bir API anahtarına ihtiyacınız vardır. 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 Key (Web API Anahtarı) alanının değerini not edin.
  2. Firebase konsolunda Dynamic Links bölümünü açın.

  3. Hizmet Şartları'nı henüz kabul etmediyseniz ve Dynamic Links için bir alan ayarlamadıysanız istendiğinde bu işlemleri yapın.

    Zaten bir Dynamic Links alanınız varsa bunu not edin. Dynamic Links programatik olarak oluştururken Dynamic Links alanı sağlamanız gerekir.

Uzun bir Dynamic Link kısaltmak için Firebase Dynamic Links API'yi kullanabilirsiniz. Bunu yapmak için longDynamicLink parametresinde uzun Dynamic Link değerini belirterek shortLinks uç noktasına bir HTTP POST isteği gönderin. Ö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 Dynamic Links oluşturmayı öğrenmek için URL'yi manuel olarak oluşturma bölümüne bakın.

Dynamic Link parametrelerini doğrudan belirterek de kısa bir Dynamic Link oluşturabilirsiniz. Bunu yapmak için shortLinks uç noktasına bir HTTP POST isteği gönderin ve dynamicLinkInfo parametresinde Dynamic Link parametrelerini belirtin. Ö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 spesifikasyonu için API referansına bakın.

Shorts videosunun uzunluğunu ayarlama Dynamic Link

Kısa Dynamic Link URL'sinin yol bileşeninin nasıl oluşturulacağını 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 olur:

https://example.page.link/UVWXYZuvwxyz12345

Bu dizeler, rastgele oluşturulmuş 96 bitlik sayıların base62 kodlamasıyla oluşturulur. Dynamic Links URL'lerinizin tahmin edilmesini ve taranmasını önlemek için bu ayarı kullanın. Bu sayede, hassas bilgilerin istenmeyen alıcılara gösterilmesini engelleyebilirsiniz.

Parametreyi "SHORT" olarak ayarlarsanız yol bileşeni, yalnızca benzersiz olması için gereken uzunlukta (en az 4 karakter) bir dize olur.

https://example.page.link/WXYZ

Kısa bir Dynamic Link URL'nin tahmin edilmesi durumunda hassas bilgiler açığa çıkmayacaksa bu yöntemi kullanın.

Aşağıdaki örnekte, suffix parametresini nasıl ayarlayabileceğiniz gösterilmektedir:

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 URL kalıpları izin verilenler listesiyle de eşleşmelidir. Aksi takdirde, oluşturma API'si HTTP hata kodu 400 ile başarısız olur.

Sonraki adımlar

Dynamic Links oluşturduğunuza göre uygulamanızı Dynamic Links alacak ve kullanıcılar açtıktan sonra onları uygulamanızda doğru yere yönlendirecek şekilde ayarlamanız gerekir.

Uygulamanızda Dynamic Links almak için iOS, Android, C++ ve Unity belgelerine bakın.

İstekler, saniyede IP adresi başına 5 istek ve günde 200.000 istek ile sınırlıdır. Bu sınır aşılırsa yanıt, HTTP hata kodu 429'u döndürür.