Dynamic Links mit der REST API erstellen

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

https://example.page.link/WXYZ

Mit der API und dem Client-SDK (Android/Apple) erstellte Kurzvideos Dynamic Links werden in der Firebase-Konsole nicht angezeigt. Solche Dynamic Links sind für die Freigabe zwischen Nutzern vorgesehen. Für Marketinganwendungen können Sie Ihre Links weiterhin direkt über die Dynamic Links-Seite in der Firebase-Konsole erstellen.

Hinweis

  1. Rufen Sie Ihren API-Schlüssel ab. Sie benötigen einen API-Schlüssel, um Ihre Anfragen an die API zu authentifizieren. So rufen Sie Ihren API-Schlüssel auf:
    1. Öffne die Seite „Einstellungen“ der Firebase-Konsole. 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 Key.
  2. Öffnen Sie in der Firebase Console den Bereich Dynamic Links.
  3. Wenn Sie die Nutzungsbedingungen noch nicht akzeptiert und keine Domain für Ihre Dynamic Links festgelegt haben, tun Sie dies, wenn Sie dazu aufgefordert werden.

    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.

Mit der Firebase Dynamic Links API können Sie lange Dynamic Link kürzen. Stellen Sie dazu eine HTTP-POST-Anfrage an den Endpunkt shortLinks und geben Sie die lange Dynamic Link im Parameter longDynamicLink 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. Stellen 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 Kurzinfo Dynamic Link generiert wird.

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

https://example.page.link/UVWXYZuvwxyz12345

Solche Strings werden durch Base62-Codierung von zufällig generierten 96‑Bit-Zahlen erstellt. Mit dieser Einstellung können Sie verhindern, dass Ihre Dynamic Links-URLs erraten und gecrawlt werden, was potenziell dazu führen kann, dass vertrauliche Informationen an unbeabsichtigte Empfänger weitergegeben werden.

Wenn Sie den Parameter auf "SHORT" festlegen, ist die Pfadkomponente ein String, der nur so lang ist, wie es für die Eindeutigkeit erforderlich ist. Die Mindestlänge beträgt 4 Zeichen.

https://example.page.link/WXYZ

Verwenden Sie diese Methode, wenn vertrauliche Informationen nicht offengelegt werden, wenn eine kurze Dynamic Link-URL erraten wird.

Das folgende Beispiel zeigt, wie Sie den Parameter suffix festlegen:

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 den Schemas „http://“ oder „https://“ beginnen. Außerdem muss sie mit allen URL-Mustern auf der in der Console eingegebenen 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 an die richtige Stelle in Ihrer App weiterleitet, nachdem sie sie geöffnet haben.

Weitere Informationen dazu, wie Sie Dynamic Links in Ihrer App erhalten, finden Sie in der Dokumentation für iOS, Android, C++ und Unity.

Anfragen sind auf 5 Anfragen/IP-Adresse/Sekunde und 200.000 Anfragen/Tag beschränkt. Wird das Limit überschritten, wird in der Antwort der HTTP-Fehlercode 429 zurückgegeben. Wenn Sie ein größeres Kontingent benötigen, füllen Sie bitte dieses Formular aus.