Dynamic Links mit der REST API erstellen

Sie können mit der Firebase Dynamic Links REST API 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

Kurze Dynamic Links die mit der API und dem Client-SDK (Android/Apple) erstellt wurden, werden in der Firebase Console nicht angezeigt. Solche Dynamic Links sind für die gemeinsame Nutzung zwischen Nutzern vorgesehen. Für Marketinganwendungsfälle erstellen Sie Links weiterhin direkt über die Dynamic Links Seite der Firebase Console.

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 finden Sie Ihren API-Schlüssel:
    1. Öffnen Sie in der Firebase Console die Settings page. Wenn Sie aufgefordert werden, ein Projekt auszuwählen, wählen Sie im Menü Ihr Firebase-Projekt aus.
    2. Notieren Sie sich den Wert des Felds Web-API-Schlüssel.
  2. Öffnen Sie in der Firebase Console den Dynamic Links Bereich.

  3. Wenn Sie die Nutzungsbedingungen noch nicht akzeptiert und eine 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 sie sich. Sie müssen eine Dynamic Links-Domain angeben, wenn Sie Dynamic Links programmatisch erstellen.

Mit der Firebase Dynamic Links API können Sie einen langen Dynamic Link kürzen. Dazu stellen Sie eine HTTP-POST-Anfrage an den shortLinks Endpunkt und geben den langen Dynamic Link im longDynamicLink Parameter 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"
}

Unter URL manuell erstellen erfahren Sie, wie Sie lange Dynamic Links erstellen.

Sie können auch einen kurzen Dynamic Link erstellen, indem Sie die Dynamic Link Parameter direkt angeben. Dazu stellen Sie eine HTTP-POST-Anfrage an den shortLinks Endpunkt und geben die Dynamic Link Parameter im dynamicLinkInfo Parameter 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 Objekts dynamicLinkInfo finden Sie in der API-Referenz.

Länge eines kurzen Dynamic Link festlegen

Sie können auch den suffix Parameter festlegen, um anzugeben, wie die Pfadkomponente des kurzen 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 die Base62-Codierung von zufällig generierten 96-Bit-Zahlen erstellt. Mit dieser Einstellung verhindern Sie, dass Ihre Dynamic Links URLs erraten und gecrawlt werden, wodurch möglicherweise vertrauliche Informationen an nicht autorisierte Empfänger weitergegeben werden können.

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

https://example.page.link/WXYZ

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

Im folgenden Beispiel wird gezeigt, wie Sie den suffix Parameter 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 den Schemas „http://“ oder „https://“ beginnen. Er muss auch mit allen URL-Mustern auf der Zulassungsliste übereinstimmen, die in der Console eingegeben wurden. 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 empfangen kann 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 und 200.000 Anfragen pro Tag begrenzt. Wenn diese Grenzwerte überschritten werden, wird in der Antwort der HTTP-Fehlercode 429 zurückgegeben. Wenn Sie ein höutrales Kontingent beantragen möchten, füllen Sie dieses Formular aus.