Syntax der Anweisungsliste

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

Speicherort der Anweisungsliste

Unter Kontoauszugsliste erstellen erfahren Sie, wo diese Liste gespeichert werden sollte.

Syntax

Die Anweisungsliste oder das Snippet besteht aus einem JSON-Array mit einer oder mehreren Website- oder App-Anweisungen als JSON-Objekte. Diese Anweisungen können in beliebiger Reihenfolge angegeben werden. Hier ist die allgemeine Syntax:

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

relation

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

Ziel

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

• Websiteziel

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

  Namespace

  Muss für Websites web sein.

  Website

  Der URI der Website, die das Ziel der Anweisung ist, im Format http[s]://<hostname>[:<port>]. Dabei ist <hostname> voll qualifiziert und <port> muss weggelassen werden, wenn Port 80 für HTTP oder Port 443 für HTTPS verwendet wird. Ein Website-Ziel kann nur eine Stammdomain sein. Sie können sich nicht auf ein bestimmtes Unterverzeichnis beschränken. Alle Verzeichnisse unter diesem Stammverzeichnis werden übereinstimmen. Subdomains sollten nicht als übereinstimmend angesehen werden. Wenn die Anweisungsdatei also auf www.beispiel.de gehostet wird, sollte www.welpen.beispiel.de nicht als Übereinstimmung betrachtet werden. Regeln und Beispiele für den Abgleich von Websitezielen finden Sie in der Dokumentation zu den Zielen. Beispiel: http://www.example.com

• Android-App-Ziel

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

  Namespace

  Muss android_app für Android-Apps sein.

  package_name

  Der voll qualifizierte Paketname der App, für die diese Anweisung gilt. Beispiel: com.google.android.apps.maps

  sha256_cert_fingerprints

  Der SHA265-Fingerabdruck in Großbuchstaben des Zertifikats der App, für die diese Anweisung gilt. Sie können dies mit openssl oder Java keytool wie hier gezeigt 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 die Play App-Signatur für deine App verwendest, stimmt der durch die lokale Ausführung von keytool oder openssl erstellte Zertifikatfingerabdruck in der Regel nicht mit dem Fingerabdruck auf den Geräten der Nutzer überein. In deinem Play Console-Entwicklerkonto unter Release > Setup > App Integrity kannst du prüfen, ob du die Play App-Signatur für deine App verwendest. In diesem Fall findest du auf derselben Seite auch das richtige Digital Asset Links-JSON-Snippet für deine App.

Beispielanweisungsliste

Hier ist ein Beispiel für eine Liste mit Aussagen zu Websites und Apps: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Skalierung auf Dutzende oder mehr Anweisungen

In einigen Fällen möchte ein Hauptkonto viele verschiedene Aussagen zu unterschiedlichen Zielen treffen oder es muss für dieselbe Gruppe von Zielen Anweisungen von verschiedenen Hauptkonten ausgegeben werden. Beispielsweise kann eine Website auf vielen verschiedenen Top-Level-Domains pro Land verfügbar sein und alle sollten eine Aussage über dieselbe mobile App machen.

In diesen Situationen kann das Einschließen von Anweisungen hilfreich sein. Mit diesem Mechanismus können Sie Verweise von vielen verschiedenen Hauptkonten zu einem zentralen Ort einrichten, der Anweisungen für alle Hauptkonten definiert.

Sie können beispielsweise den zentralen Speicherort „https://example.com/includedstatements.json“ auswählen. Diese Datei kann so konfiguriert werden, dass sie den gleichen Inhalt wie in den obigen Beispielen enthält.

Um einen Zeiger von einer Website auf die Einschlussdatei einzurichten, ändern Sie „https://example.com/.well-known/assetlinks.json“ in:

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

Um einen Zeiger von einer Android-App auf die include-Datei einzurichten, ä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 Formats der Listenliste und der zugrunde liegenden Konzepte finden Sie in unserem Spezifikationsdokument.