Determina se esiste una relazione (direzionale) specificata tra gli asset di origine e di destinazione specificati.
La relazione descrive l'intento del collegamento tra le due risorse rivendicate dalla risorsa di origine. Un esempio di queste relazioni è la delega di privilegi o autorizzazioni.
Questo comando viene utilizzato principalmente dai sistemi dell'infrastruttura per verificare le condizioni preliminari per un'azione. Ad esempio, un cliente potrebbe voler sapere se è possibile inviare un URL web a una determinata app mobile. Il cliente può cercare il link dell'asset pertinente dal sito web all'app mobile per decidere se l'operazione deve essere consentita.
Nota sulla sicurezza: se specifichi un asset sicuro come origine, ad esempio un sito web HTTPS o un'app per Android, l'API garantirà che tutte le istruzioni utilizzate per generare la risposta siano state effettuate in modo sicuro dal proprietario dell'asset. Al contrario, se l'asset di origine è un sito web HTTP non sicuro (ovvero l'URL inizia con http://
anziché https://
), l'API non può verificare le proprie dichiarazioni in modo sicuro e non è possibile garantire che le istruzioni del sito web non siano state alterate da una terza parte. Per ulteriori informazioni, consulta la specifica di progettazione tecnica di Digital Asset Links.
Richiesta HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parametri di ricerca
Nome del parametro | Tipo | Descrizione |
---|---|---|
source |
object( |
La fonte che ospita l'elenco degli estratti conto. Viene utilizzato per instradare la chiamata Check() all'origine corretta. |
relation |
string |
Stringa di query per la relazione. Identifichiamo le relazioni con stringhe del formato Per l'elenco aggiornato delle relazioni supportate, consulta la documentazione relativa all'API. Affinché una query corrisponda a un link di asset, le stringhe di relazione della query e del link dell'asset devono corrispondere esattamente. Esempio: una query con relazione |
target |
object( |
L'asset target dell'estratto conto. |
Corpo della richiesta
Il corpo della richiesta deve essere vuoto.
Corpo della risposta
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Messaggio di risposta per la chiamata CheckAssetLinks.
Rappresentazione JSON |
---|
{ "linked": boolean, "maxAge": string, "debugString": string, } |
Nome campo | Tipo | Descrizione |
---|---|---|
linked |
boolean |
Viene impostato su true se gli asset specificati nella richiesta sono collegati dalla relazione specificata nella richiesta. REQUIRED |
maxAge |
string |
Dalla pubblicazione, indica per quanto tempo la risposta deve essere considerata valida salvo ulteriori aggiornamenti. REQUIRED Durata in secondi con un massimo di nove cifre frazionarie, terminata con " |
debugString |
string |
Messaggio leggibile contenente informazioni destinate ad aiutare gli utenti finali a comprendere, riprodurre ed eseguire il debug del risultato. Il messaggio sarà in inglese e al momento non prevediamo di offrire alcuna traduzione. Tieni presente che non vengono garantite garanzie in merito ai contenuti o al formato di questa stringa. Qualsiasi suo aspetto potrebbe essere soggetto a modifica senza preavviso. Non tentare di analizzare questi dati in modo programmatico. Se ritieni di dover svolgere questa operazione perché le informazioni di cui hai bisogno non vengono altrimenti esposte dall'API, contattaci. |
Prova.
Utilizza Explorer API per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.