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:

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.