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

Firebase Dynamic Links REST API ile kısa Dinamik Bağlantılar oluşturabilirsiniz. Bu API, uzun bir Dinamik Bağlantı'yı veya Dynamic Link parametrelerini içeren bir nesneyi kabul eder ve aşağıdaki örnektekine benzer 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örünmez. Bu tür Dinamik Bağlantılar, kullanıcılar arasında paylaşım için tasarlanmıştır. Pazarlama kullanım alanlarında, bağlantılarınızı doğrudan Firebase konsolunun Dinamik Bağlantılar sayfasından oluşturmaya devam edin.

Başlamadan önce

  1. API anahtarınızı alın. API isteklerinizin kimliğini doğrulamak için bir API anahtarına ihtiyacınız olacaktır. API anahtarınızı bulmak için:
    1. Firebase konsolunun Ayarlar sayfasını açın. Proje seçmeniz istenirse menüden Firebase projenizi seçin.
    2. Web API Anahtarı alanının değerine dikkat edin.
  2. Firebase konsolunda Dinamik Bağlantılar bölümünü açın.

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

    Zaten bir Dynamic Links alan adınız varsa bunu not edin. Programatik olarak Dynamic Links oluştururken bir Dynamic Links alan adı 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 oluşturun. Örnek:

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 Manuel olarak URL oluşturma bölümüne bakın.

Ayrıca, Dinamik Bağlantı parametrelerini doğrudan belirterek 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 gönderin. Örnek:

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.

Kısa bir 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" değerine ayarlarsanız yol bileşeni, aşağıdaki örnekte gösterildiği gibi 17 karakterden oluşan bir dize olur:

https://example.page.link/UVWXYZuvwxyz12345

Bu tür dizeler, rastgele oluşturulmuş 96 bitlik sayılarla base62 kodlamasıyla oluşturulur. Dynamic Links URL'lerinizin tahmin edilmesini ve taranmasını önlemek için bu ayarı kullanın. Bu durum, hassas bilgilerin istenmeyen alıcılar tarafından görülmesine neden olabilir.

Parametreyi "SHORT" olarak ayarlarsanız yol bileşeni, en az 4 karakter uzunluğunda olmak üzere yalnızca benzersiz olması gereken uzunlukta bir dize olur.

https://example.page.link/WXYZ

Kısa bir Dynamic Link URL'si tahmin edildiğinde hassas bilgiler açığa çıkarılmayacaksa 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ı ile başlamalıdır. Ayrıca, konsolda girilen 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 Dynamic Links'i 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 yönlendirecek şekilde ayarlamanız gerekir.

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

İstekler, saniye başına IP adresi başına 5 istek ve günde 200.000 istek ile sınırlıdır. Aşılırsa yanıt, 429 HTTP hata kodu döndürür. Daha fazla kota isteğinde bulunmak için bu formu doldurun.