Dynamic Links mit der REST API erstellen

Mit der Firebase Dynamic Links REST API können Sie kurze Dynamic Links erstellen. Diese API akzeptiert entweder einen langen Dynamic Link oder ein Objekt mit Dynamic Link-Parametern und gibt eine URL wie im folgenden Beispiel zurück:

https://example.page.link/WXYZ

Kurz-Dynamic Links, die mit der API und dem Client-SDK (Android/Apple) erstellt wurden, werden nicht in der Firebase-Konsole angezeigt. Solche Dynamic Links sind für die Weitergabe von Nutzer zu Nutzer gedacht. Für Marketinganwendungsfälle können Sie Ihre Links weiterhin direkt über die Seite Dynamic Links der Firebase Console erstellen.

Hinweis

  1. API-Schlüssel abrufen Sie benötigen einen API-Schlüssel, um Ihre Anfragen an die API zu authentifizieren. So finden Sie Ihren API-Schlüssel:
    1. Öffnen Sie in der Firebase Console die Seite „Einstellungen“. Wenn Sie aufgefordert werden, ein Projekt auszuwählen, wählen Sie Ihr Firebase-Projekt aus dem Menü aus.
    2. Notieren Sie sich den Wert des Felds Web API-Schlüssel.
  2. Öffnen Sie in der Firebase Console den Bereich Dynamic Links.

  3. Wenn Sie die Nutzungsbedingungen noch nicht akzeptiert und keine Domain für Dynamic Links festgelegt haben, werden Sie dazu aufgefordert.

    Wenn Sie bereits eine Dynamic Links-Domain haben, notieren Sie sich diese. Sie müssen eine Dynamic Links-Domain angeben, wenn Sie Dynamic Links programmatisch erstellen.

Sie können die Firebase Dynamic Links API verwenden, um eine lange Dynamic Link zu kürzen. Senden Sie dazu eine HTTP-POST-Anfrage an den Endpunkt shortLinks und geben Sie im Parameter longDynamicLink die lange Dynamic Link an. Beispiel:

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

Informationen zum Erstellen langer Dynamic Links finden Sie unter URL manuell erstellen.

Sie können auch eine kurze Dynamic Link erstellen, indem Sie die Dynamic Link-Parameter direkt angeben. Senden Sie dazu eine HTTP-POST-Anfrage an den Endpunkt shortLinks und geben Sie die Dynamic Link-Parameter im Parameter dynamicLinkInfo an. Beispiel:

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

Eine vollständige Spezifikation des dynamicLinkInfo-Objekts finden Sie in der API-Referenz.

Länge eines Kurzvideos festlegen: Dynamic Link

Sie können auch den Parameter suffix festlegen, um anzugeben, wie die Pfadkomponente der Kurz-Dynamic Link generiert wird.

Standardmäßig oder wenn Sie den Parameter auf "UNGUESSABLE" setzen, ist die Pfadkomponente ein String mit 17 Zeichen, wie im folgenden Beispiel:

https://example.page.link/UVWXYZuvwxyz12345

Solche Strings werden durch Base62-Codierung zufällig generierter 96-Bit-Zahlen erstellt. Mit dieser Einstellung können Sie verhindern, dass Ihre Dynamic Links-URLs erraten und gecrawlt werden, wodurch vertrauliche Informationen möglicherweise an unbeabsichtigte Empfänger weitergegeben werden könnten.

Wenn Sie den Parameter auf "SHORT" setzen, ist die Pfadkomponente ein String, der nur so lang ist, wie für die Eindeutigkeit erforderlich, mit einer Mindestlänge von 4 Zeichen.

https://example.page.link/WXYZ

Verwenden Sie diese Methode, wenn keine vertraulichen Informationen preisgegeben werden, falls eine kurze Dynamic Link-URL erraten wird.

Im folgenden Beispiel wird gezeigt, wie Sie den Parameter suffix festlegen können:

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

Der angegebene Deeplink-Wert muss mindestens mit „http://“ oder „https://“ beginnen. Sie muss auch mit allen in der Konsole eingegebenen URL-Mustern auf der Zulassungsliste übereinstimmen. Andernfalls schlägt die Erstellungs-API mit dem HTTP-Fehlercode 400 fehl.

Nächste Schritte

Nachdem Sie Dynamic Links erstellt haben, müssen Sie Ihre App so einrichten, dass sie Dynamic Links empfängt und Nutzer nach dem Öffnen an die richtige Stelle in Ihrer App weiterleitet.

Informationen zum Empfangen von Dynamic Links in Ihrer App finden Sie in der Dokumentation für iOS, Android, C++ und Unity.

Anfragen sind auf 5 Anfragen pro IP-Adresse und Sekunde sowie 200.000 Anfragen pro Tag beschränkt. Wenn das Limit überschritten wird, wird der HTTP-Fehlercode 429 zurückgegeben.