Method assetlinks.check

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

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