Method statements.list

Recupera un elenco di tutte le istruzioni di una determinata origine che corrispondono al target e alla stringa di istruzioni specificati.

L'API garantisce che tutte le dichiarazioni con asset di origine sicuri, ad esempio siti web HTTPS o app per Android, siano state effettuate in modo sicuro dal proprietario di tali asset, come descritto nelle specifiche di progettazione tecnica di Digital Asset Links. In particolare, devi tenere presente che per i siti web non sicuri (ovvero dove l'URL inizia con http:// anziché https://), questa garanzia non può essere fornita.

Il comando List è utile soprattutto nei casi in cui il client API voglia conoscere tutti i modi in cui due asset sono correlati o enumerare tutte le relazioni di un determinato asset di origine. Esempio: una funzionalità che aiuta gli utenti a raggiungere elementi correlati. Quando un'app mobile è in esecuzione su un dispositivo, la funzione semplifica l'accesso 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 fonte che ospita l'elenco degli estratti conto. Viene utilizzato per indirizzare la richiesta List() all'origine corretta. REQUIRED
relation string

Utilizza solo le associazioni che corrispondono alla relazione specificata.

Vedi il messaggio Statement per una definizione dettagliata delle stringhe di relazione.

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

  • 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 di asset con la 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 dell'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

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.

Affermazione

Descrive un'affermazione attendibile relativa alla relazione tra una risorsa di origine e una risorsa target.

Le dichiarazioni vengono sempre effettuate dalla risorsa di origine, direttamente o delegandole a un elenco di dichiarazioni archiviato altrove.

Per definizioni più dettagliate di estratti conto e asset, consulta la pagina di destinazione della documentazione API.

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

La relazione identifica l'uso della dichiarazione come previsto dal proprietario della risorsa di origine (ovvero la persona o la persona giuridica che ha emesso la dichiarazione). Ogni affermazione completa ha una 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.

Esempio: delegate_permission/common.handle_all_urls OBBLIGATORIO
target object(Asset) Ogni estratto conto ha un asset target. REQUIRED

Prova.

Utilizza Explorer API per chiamare questo metodo sui dati in tempo reale e visualizzare la risposta.