Syntax der Anweisungsliste

Eine Anweisungsliste ist eine JSON-codierte Datei oder ein Snippet an einem bekannten Speicherort.

Position der Auszugsliste

Informationen dazu, wo diese Liste gespeichert werden sollte, finden Sie unter Anweisungsliste erstellen.

Syntax

Die Anweisungsliste oder das Snippet besteht aus einem JSON-Array aus einer oder mehreren Website- oder App-Anweisungen als JSON-Objekte. Diese Anweisungen können eine beliebige Reihenfolge haben. Hier ist die allgemeine Syntax:

[
  {
    "relation": ["relation_string"],
    "target": {target_object}
  } , ...
]

Beziehung

Ein Array mit einem oder mehreren Strings, die die Beziehung beschreiben, die für das Ziel deklariert wird. Siehe die Liste der definierten Beziehungsstrings. Beispiel:delegate_permission/common.handle_all_urls

target

Das Ziel-Asset, für das diese Anweisung gilt. Verfügbare Zieltypen:

• Websiteziel

  "target": {
    "namespace": "web",
    "site": "site_root_url"
  }

  Namespace

  Der Wert muss für Websites web sein.

  Website

  URI der Website, auf die die Anweisung ausgerichtet ist, im Format http[s]://<hostname>[:<port>], wobei <hostname> vollständig qualifiziert ist und <port> bei Verwendung von Port 80 für HTTP oder Port 443 für HTTPS weggelassen werden muss. Ein Websiteziel kann nur eine Stammdomain sein. Eine Beschränkung auf ein bestimmtes Unterverzeichnis ist nicht zulässig. Alle Verzeichnisse unter diesem Stammverzeichnis werden übereinstimmen. Subdomains sollten nicht abgeglichen werden. Das heißt, wenn die Anweisungsdatei auf www.beispiel.de gehostet wird, sollte www.welpen.beispiel.de nicht als Übereinstimmung angesehen werden. Regeln und Beispiele zum Abgleich von Websitezielen finden Sie in der Dokumentation zu Zielen. Beispiel:http://www.example.com

• Ziel für Android-App

  "target": {
    "namespace": "android_app",
    "package_name": "fully_qualified_package_name",
    "sha256_cert_fingerprints": ["cert_fingerprint"]
  }

  Namespace

  Der Wert muss für Android-Apps android_app lauten.

  Paketname

  Der voll qualifizierte Paketname der App, für den diese Erklärung gilt. Beispiel: com.google.android.apps.maps

  SHA256_Zertifikatfingerabdrücke

  Der SHA265-Fingerabdruck des Zertifikats für die App, für die diese Anweisung gilt. Sie können diesen Wert mit openssl oder Java keytool berechnen:

  • openssl x509 -in $CERTFILE -noout -fingerprint -sha256
  • keytool -printcert -file $CERTFILE | grep SHA256

  Beispiel: ["14:6D:E9:83:C5:73:06:50:D8:EE:B9:95:2F:34:FC:64:16:A0:83:42:E6:1D:BE:A8:8A:04:96:B2:3F:CF:44:E5"].

  Wenn du für deine App die Play App-Signatur verwendest, stimmt der mit der lokalen Ausführung von keytool oder openssl erstellte Zertifikatfingerabdruck in der Regel nicht mit dem Fingerabdruck auf den Geräten der Nutzer überein. Du kannst prüfen, ob du die Play App-Signatur für deine App in deinem Play Console-Entwicklerkonto unter Release > Setup > App Integrity verwendest. In diesem Fall findest du auf dieser Seite auch das richtige Digital Asset Links-JSON-Snippet.

Liste mit Beispielanweisungen

Hier findest du eine Beispielliste für eine Website-Erklärung, die sowohl Informationen zu Websites als auch zu Apps enthält: http://beispiel.digitalassetlinks.org/.well-known/assetlinks.json

Skalierung auf Dutzende von Anweisungen oder mehr

In einigen Fällen möchte ein Hauptkonto möglicherweise viele verschiedene Anweisungen zu verschiedenen Zielen oder es müssen verschiedene Hauptkonten Erklärungen zu denselben Zielen ausstellen. Beispielsweise kann eine Website in vielen verschiedenen Top-Level-Domains pro Land verfügbar sein und alle möchten eine Aussage über dieselbe mobile App treffen.

In diesen Fällen kann es hilfreich sein, die Anweisungen einzufügen. Mit diesem Mechanismus können Sie Zeiger von vielen verschiedenen Hauptkonten an einem zentralen Ort einrichten, der Anweisungen für alle Hauptkonten definiert.

Hinweis: In einer vollständigen Liste der Anweisungslisten sind maximal zehn Include-Anweisungen zulässig. Die maximale Anzahl der Dateien in der Baumstruktur ist also: (10 eingeschlossene Anweisungsdateien) + (Stammdatei der Anweisung) = 11.

Sie können beispielsweise den zentralen Speicherort "https://example.com/includedstatements.json" festlegen. Diese Datei kann so konfiguriert werden, dass sie dieselben Inhalte wie in den obigen Beispielen enthält.

Ändern Sie „https://beispiel.de/.well-known/assetlinks.json“ so, dass ein Verweis von einer Website zur Einschlussdatei eingerichtet wird:

[{
  "include": "https://example.com/includedstatements.json"
}]

Wenn Sie einen Zeiger von einer Android-App auf die Include-Datei einrichten möchten, ändern Sie „res/values/strings.xml“ in:

<resources>
  ...
  <string name="asset_statements">
    [{
      \"include\": \"https://example.com/includedstatements.json\"
    }]
  </string>
</resources>

Weitere Informationen

Eine ausführlichere Erläuterung des Anweisungsformats und der zugrunde liegenden Konzepte finden Sie in unserer Spezifikation.