Diese Seite wurde von der Cloud Translation API übersetzt.

Syntax der Anweisungsliste

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

Speicherort der Erklärungsliste

Informationen dazu, wo diese Liste gespeichert werden sollte, finden Sie unter Erklärung erstellen.

Syntax

Die Erklärungsliste oder das Snippet besteht aus einem JSON-Array mit einer oder mehreren Website- oder App-Erklärungen als JSON-Objekte. Diese Anweisungen können in beliebiger Reihenfolge stehen. So sieht die allgemeine Syntax aus:

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

relation

Ein Array mit einem oder mehreren Strings, die die Beziehung zum Ziel beschreiben. Liste der definierten Beziehungsstrings Beispiel:delegate_permission/common.handle_all_urls

Ziel

Das Ziel-Asset, auf das sich diese Aussage bezieht. Verfügbare Zieltypen:

Website-Ziel
```
"target": {
  "namespace": "web",
  "site": "site_root_url"
}
```
Namespace

Muss für Websites web sein.

Website

URI der Website, die das Ziel der Anweisung ist, im Format http[s]://<hostname>[:<port>], wobei <hostname> vollqualifiziert ist und <port> weggelassen werden muss, 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 es nicht auf ein bestimmtes Unterverzeichnis beschränken. Alle Verzeichnisse unter dieser Stammdomain werden berücksichtigt. Subdomains sollten nicht als Übereinstimmung betrachtet werden. Wenn die Erklärungsdatei 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 Website-Zielen finden Sie in der Dokumentation zu 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 für Android-Apps android_app sein.

package_name

Der vollständig qualifizierte Paketname der App, auf die sich diese Erklärung bezieht. Beispiel: com.google.android.apps.maps

sha256_cert_fingerprints
Der SHA256-Fingerabdruck in Großbuchstaben des Zertifikats für die App, auf die sich diese Anweisung bezieht. Sie können diesen Wert mit openssl oder Java keytool berechnen, wie hier gezeigt:
- 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 Sie die Play App-Signatur für Ihre App verwenden, stimmt der Zertifikatsfingerabdruck, der durch lokales Ausführen von keytool oder openssl generiert wird, in der Regel nicht mit dem auf den Geräten der Nutzer überein. In Ihrem Play Console-Entwicklerkonto können Sie unter Release > Setup > App Integrity nachsehen, ob Sie die Play App-Signatur für Ihre App verwenden. Wenn dies der Fall ist, finden Sie auf derselben Seite auch den richtigen JSON-Snippet für Digital Asset Links für Ihre App.

relation_extensions (optional)

Sie können einer Erklärung ein optionales relation_extensions-Feld hinzufügen, um weitere Informationen zu den Berechtigungen und Verknüpfungen anzugeben, die Sie gewähren möchten. Dieses Feld sollte ein Objekt sein, in dem jeder Schlüssel ein Beziehungsstring ist und der Wert ein Objekt mit den Erweiterungen für diese Beziehung. Clients, die diese Erklärungen anfordern, müssen aktualisiert werden, damit diese Felder berücksichtigt werden.

relation_extensions für die Beziehung delegate_permission/common.handle_all_urls könnte beispielsweise so aussehen:

  {
    "relation": ["delegate_permission/common.handle_all_urls"],
    "target": {
      "namespace": "android_app",
      "package_name": "com.example.app",
      "sha256_cert_fingerprints": ["..."]
    },
    "relation_extensions": {
      "delegate_permission/common.handle_all_urls": {...}
    }
  }

Die DAL API unterstützt die Rückgabe von „relation_extensions“ in API-Aufrufen, wenn der Parameter return_relation_extensions=true in der Anfrage festgelegt ist.

Beispielliste mit Aussagen

Hier ist ein Beispiel für eine Website-Anweisungsliste, die Anweisungen zu Websites und Apps enthält: http://example.digitalassetlinks.org/.well-known/assetlinks.json

Auf Dutzende von Kontoauszügen oder mehr skalieren

In einigen Fällen möchte ein Rechtssubjekt möglicherweise viele verschiedene Erklärungen zu verschiedenen Zielen abgeben oder es ist erforderlich, Erklärungen von verschiedenen Rechtssubjekten an dieselben Ziele zu richten. Eine Website ist beispielsweise möglicherweise in vielen verschiedenen länderspezifischen Top-Level-Domains verfügbar und alle möchten eine Aussage zur selben mobilen App machen.

In diesen Fällen können Include-Anweisungen hilfreich sein. Mit diesem Mechanismus können Sie Zeiger von vielen verschiedenen Principals auf einen zentralen Ort einrichten, an dem Anweisungen für alle Principals definiert werden.

Sie können beispielsweise festlegen, dass der zentrale Speicherort `https://example.com/includedstatements.json` sein soll. Diese Datei kann so konfiguriert werden, dass sie denselben Inhalt wie in den obigen Beispielen enthält.

Um einen Verweis von einer Website auf die Include-Datei einzurichten, ändern Sie `https://example.com/.well-known/assetlinks.json` in:

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

Wenn Sie einen Zeiger von einer Android-App zur Include-Datei einrichten möchten, ändern Sie `res/values/strings.xml` so:

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

Weitere Informationen

Eine detailliertere Erläuterung des Anweisungslistenformats und der zugrunde liegenden Konzepte finden Sie in unserem Spezifikationsdokument.