Method assetlinks.check

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(Asset) 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 <kind>/<detail>, dove <kind> deve far parte di un insieme di categorie di scopi predefinite e <detail> è una stringa alfanumerica minuscola in formato libero che descrive il caso d'uso specifico della dichiarazione.

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 delegate_permission/common.handle_all_urls corrisponde a un link dell'asset con relazione delegate_permission/common.handle_all_urls.
target object(Asset) 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 "s". Esempio: "3.5s".
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.