Method assetlinks.check

Damit wird festgelegt, ob die angegebene (direktionale) Beziehung zwischen den angegebenen Quell- und Ziel-Assets besteht.

Die Beziehung beschreibt die Absicht der Verknüpfung zwischen den beiden Assets, die vom Quell-Asset beansprucht werden. Ein Beispiel für solche Beziehungen ist das Delegieren von Berechtigungen.

Dieser Befehl wird am häufigsten von Infrastruktursystemen verwendet, um die Vorbedingungen für eine Aktion zu prüfen. Beispielsweise möchte ein Kunde möglicherweise wissen, ob es in Ordnung ist, stattdessen eine Web-URL an eine bestimmte mobile App zu senden. Der Kunde kann nach dem relevanten Asset-Link von der Website zur mobilen App suchen und dann entscheiden, ob der Vorgang zulässig ist.

Hinweis zur Sicherheit: Wenn du ein sicheres Asset als Quelle angibst, z. B. eine HTTPS-Website oder eine Android-App, sorgt die API dafür, dass alle Anweisungen, die zum Generieren der Antwort verwendet werden, auf sichere Weise vom Inhaber des Assets vorgenommen wurden. Wenn das Quell-Asset hingegen eine unsichere HTTP-Website ist (d. h. die URL beginnt mit http:// statt mit https://), kann die API die Anweisungen nicht sicher überprüfen und es kann nicht sichergestellt werden, dass die Angaben der Website nicht von Dritten geändert wurden. Weitere Informationen finden Sie in der technischen Designspezifikation zu Digital Asset Links.

HTTP-Anfrage

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

Abfrageparameter

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

Abfragestring für die Beziehung.

Wir identifizieren Beziehungen mit Strings im Format <kind>/<detail>, wobei <kind> eine aus einer Reihe vordefinierter Zweckkategorien sein muss und <detail> ein kleingeschriebener alphanumerischer String im freien Format 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 übereinstimmt, müssen die Beziehungsstrings der Abfrage und des Asset-Links genau übereinstimmen.

Beispiel: Eine Abfrage mit der Beziehung delegate_permission/common.handle_all_urls stimmt mit einem Asset-Link mit der Beziehung delegate_permission/common.handle_all_urls überein.
target object(Asset) Das Ziel-Asset des Kontoauszugs.

Anfragetext

Der Anfragetext muss leer sein.

Antworttext

Wenn der Vorgang erfolgreich ist, enthält der Antworttext Daten mit folgender 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 über die in der Anfrage angegebene Beziehung verknüpft sind. ERFORDERLICH
maxAge string

Ab dem Zeitpunkt der Auslieferung, wie lange die Antwort gültig sein soll, solange keine weiteren Aktualisierungen erfolgen. ERFORDERLICH

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

Eine visuell lesbare Nachricht mit Informationen, die Endnutzern helfen sollen, das Ergebnis zu verstehen, zu reproduzieren und zu debuggen.

Die Mitteilung wird auf Englisch verfasst und derzeit ist nicht geplant, sie zu übersetzen.

Beachten Sie, dass hinsichtlich des Inhalts oder Formats dieses Strings keine Garantien gegeben werden. Alle Teile davon können ohne vorherige Ankündigung geändert werden. Sie sollten nicht versuchen, diese Daten programmatisch zu parsen. Wenn Sie dies Ihrer Meinung nach tun müssen, weil die von Ihnen benötigten Informationen über die API nicht anderweitig offengelegt werden, setzen Sie sich bitte zuerst mit uns in Verbindung.

Jetzt testen

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