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:
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.
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.