Method assetlinks.check

Bestimmt, ob die angegebene (direkte) Beziehung zwischen den angegebenen Quell- und Ziel-Assets besteht.

Die Beziehung beschreibt die Absicht der Verknüpfung zwischen den beiden Assets, auf die das Quell-Asset Anspruch erhoben hat. Ein Beispiel für eine solche Beziehung ist die Bevollmächtigung von Berechtigungen oder Berechtigungen.

Dieser Befehl wird am häufigsten von Infrastruktursystemen verwendet, um Voraussetzungen für eine Aktion zu prüfen. Beispiel: Ein Kunde möchte wissen, ob eine Web-URL stattdessen an eine bestimmte mobile App gesendet werden darf. Der Kunde kann von der Website zur mobilen App nach dem relevanten Asset-Link suchen, um zu entscheiden, ob der Vorgang zulässig ist.

Hinweis zur Sicherheit: Wenn Sie ein sicheres Asset als Quelle angeben, z. B. eine HTTPS-Website oder eine Android-App, sorgt die API dafür, dass alle Anweisungen, die zur Generierung der Antwort verwendet werden, auf sichere Weise vom Inhaber des Assets stammen. Wenn umgekehrt das Quell-Asset eine unsichere HTTP-Website ist, d. h. die URL mit http:// statt https:// beginnt, können die Anweisungen der API nicht sicher geprüft werden. Außerdem kann nicht sichergestellt werden, dass die Aussagen der Website nicht von Dritten geändert wurden. Weitere Informationen finden Sie in der technischen Designspezifikation für Links zu digitalen Assets.

HTTP-Anfrage

GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check

Abfrageparameter

Parametername Typ Beschreibung
source object(Asset) Die Quelle, die die Anweisungsliste hostet. Dadurch wird der Check()-Aufruf an die richtige Quelle weitergeleitet.
relation string

Abfragestring für die Beziehung.

Wir ermitteln Beziehungen mit Strings im Format <kind>/<detail>, wobei <kind> einer der vordefinierten Zweckkategorien sein muss und <detail> ein frei definierbarer kleingeschriebener alphanumerischer String ist, der den spezifischen Anwendungsfall der Anweisung beschreibt.

Eine aktuelle Liste der unterstützten Beziehungen finden Sie in unserer API-Dokumentation.

Damit eine Abfrage mit einem Asset-Link übereinstimmen kann, müssen sowohl die Beziehungsstrings der Abfrage als auch die des Asset-Links genau übereinstimmen.

Beispiel: Eine Abfrage mit der Beziehung delegate_permission/common.handle_all_urls stimmt mit einer Asset-Verknüpfung mit der Beziehung delegate_permission/common.handle_all_urls überein.
target object(Asset) Das Ziel-Asset der Anweisung.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Bei Erfolg enthält der Antworttext Daten mit der folgenden Struktur:

Antwortnachricht für den CheckAssetLinks-Aufruf.

JSON-Darstellung 
{
  "linked": boolean,
  "maxAge": string,
  "debugString": string,
}
Feldname Typ Beschreibung
linked boolean Wird auf „true“ gesetzt, wenn die in der Anfrage angegebenen Assets mit der in der Anfrage angegebenen Beziehung verknüpft sind. ERFORDERLICH
maxAge string

Ab dem Zeitpunkt der Bereitstellung, wie lange die Antwort als gültige Aktualisierungen zu betrachten ist, abgesehen von weiteren Aktualisierungen. ERFORDERLICH

Dauer in Sekunden mit bis zu neun Nachkommastellen und einem 's' an letzter Stelle. Beispiel: "3.5s".
debugString string

Für Menschen lesbare Nachricht mit Informationen, die Endnutzern helfen sollen, das Ergebnis zu verstehen, zu reproduzieren und Fehler zu beheben.

Die Nachricht wird in englischer Sprache verfasst. Derzeit sind aber keine Übersetzungen verfügbar.

Beachten Sie, dass der Inhalt oder das Format dieses Strings nicht garantiert werden kann. Jeder Aspekt kann sich ohne vorherige Ankündigung ändern. Sie sollten nicht versuchen, diese Daten programmatisch zu parsen. Wenn Sie der Meinung sind, dass dies erforderlich ist, weil die benötigten Informationen ansonsten nicht über die API bereitgestellt werden, wenden Sie sich bitte zuerst an uns.

Testen!

Rufen Sie diese Methode mit dem APIs Explorer für Live-Daten auf und sehen Sie sich die Antwort an.