Method statements.list

Recupera un elenco di tutte le istruzioni da una determinata origine che corrispondono alla destinazione e alla stringa di istruzione specificate.

L'API garantisce che tutte le dichiarazioni con asset di origine sicuri, ad esempio siti web HTTPS o app per Android, siano state eseguite in modo sicuro dal proprietario delle risorse, come descritto nella specifica di progettazione tecnica dei link di asset digitali. Nello specifico, tieni presente che per i siti web non sicuri (ovvero dove l'URL inizia con http:// anziché con https://) non è possibile garantire questa garanzia.

Il comando List è particolarmente utile nei casi in cui il client API voglia conoscere tutti i modi in cui due asset sono correlati o enumerare tutte le relazioni di una determinata risorsa di origine. Esempio: una funzionalità che consente agli utenti di navigare tra gli elementi correlati. Quando un'app per dispositivi mobili è in esecuzione su un dispositivo, la funzione consente di passare facilmente al sito web o al profilo Google+ corrispondente.

Richiesta HTTP

GET https://digitalassetlinks.googleapis.com/v1/statements:list

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 richiesta List() alla sorgente giusta. OBBLIGATORIA
relation string

Utilizza solo associazioni che corrispondono alla relazione specificata.

Per una definizione dettagliata delle stringhe di relazione, consulta il messaggio Statement.

Affinché una query corrisponda a un'istruzione, deve essere vera una delle seguenti condizioni:

  • Le stringhe di relazione della query e dell'istruzione corrispondono esattamente oppure
  • la stringa di relazione della query è vuota o mancante.

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.

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 Elenco.

Rappresentazione JSON 
{
  "statements": [
    {
      object(Statement)
    }
  ],
  "maxAge": string,
  "debugString": string,
}
Nome campo Tipo Descrizione
statements[] object(Statement) Un elenco di tutte le istruzioni corrispondenti trovate.
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.

Affermazione

Descrive una dichiarazione affidabile sulla relazione tra un asset di origine e un asset di destinazione.

Le istruzioni sono sempre fatte dall'asset di origine, direttamente o delegando a un elenco di istruzioni memorizzato altrove.

Per una definizione più dettagliata di istruzioni e risorse, consulta la pagina di destinazione della documentazione dell'API.

Rappresentazione JSON 
{
  "source": {
    object(Asset)
  },
  "relation": string,
  "target": {
    object(Asset)
  },
}
Nome campo Tipo Descrizione
source object(Asset) Ogni istruzione ha un asset di origine. OBBLIGATORIA
relation string

La relazione identifica l'uso dell'istruzione come previsto dal proprietario della risorsa sorgente (ovvero la persona o l'entità che ha emesso la dichiarazione). Ogni dichiarazione completa ha una 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.

Esempio: delegate_permission/common.handle_all_urls OBBLIGATORIO
target object(Asset) Ogni istruzione ha un asset di destinazione. OBBLIGATORIA

Prova.

Usa Explorer API per richiamare questo metodo sui dati in tempo reale e visualizzare la risposta.