Determina se la relazione specificata (direzionale) esiste tra gli asset di origine e di destinazione specificati.
La relazione descrive l'intento del collegamento tra le due risorse come rivendicato dalla risorsa di origine. Un esempio di tali relazioni è la delega dei privilegi o delle autorizzazioni.
Questo comando viene spesso utilizzato dai sistemi di infrastruttura per verificare le condizioni preliminari per un'azione. Ad esempio, un cliente potrebbe voler sapere se è consentito inviare un URL web a una determinata app per dispositivi mobili. Per decidere se consentire o meno l'operazione, il cliente può verificare il link all'asset pertinente dal sito web all'app per dispositivi mobili.
Una nota sulla sicurezza: se specifichi un asset sicuro come origine, ad esempio un sito web HTTPS o un'app Android, l'API garantisce che tutte le istruzioni utilizzate per generare la risposta siano state inviate 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é con https://
), l'API non può verificare le proprie istruzioni in modo sicuro e non è possibile garantire che le istruzioni del sito web non siano state modificate da una terza parte. Per ulteriori informazioni, consulta la specifica di progettazione tecnica dei link asset digitali.
Richiesta HTTP
GET https://digitalassetlinks.googleapis.com/v1/assetlinks:check
Parametri di ricerca
Nome del parametro | Tipo | Descrizione |
---|---|---|
source |
object( |
La sorgente che ospita l'elenco di istruzioni. Questo viene utilizzato per indirizzare la chiamata Check() alla sorgente corretta. |
relation |
string |
Stringa di query per la relazione. Identifichiamo le relazioni con stringhe nel formato Consulta la nostra documentazione API per l'elenco aggiornato delle relazioni supportate. Affinché una query corrisponda a un link all'asset, sia le stringhe di relazione della query sia il link dell'asset devono corrispondere esattamente. Esempio: una query con relazione |
target |
object( |
L'asset di destinazione dell'istruzione. |
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 |
Impostato su vero se gli asset specificati nella richiesta sono collegati dalla relazione specificata nella richiesta. OBBLIGATORIA |
maxAge |
string |
Dal momento della pubblicazione, il periodo di tempo per cui la risposta deve essere considerata valida al netto di ulteriori aggiornamenti. OBBLIGATORIA Una durata in secondi con un massimo di nove cifre frazionarie, terminata da " |
debugString |
string |
Messaggio leggibile contenente informazioni che aiutano gli utenti finali a comprendere, riprodurre ed eseguire il debug del risultato. Il messaggio è in inglese e al momento non prevediamo di fornire traduzioni. Tieni presente che non viene fatta alcuna garanzia sui contenuti o sul formato di questa stringa. Qualsiasi suo aspetto può essere soggetto a modifiche senza preavviso. Non tentare di analizzare questi dati a livello di programmazione. Se ritieni di averne bisogno perché le informazioni di cui hai bisogno non sono mostrate in altro modo dall'API, contattaci. |
Prova.
Usa Explorer API per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.