Package google.factchecking.factchecktools.v1alpha1

Indice

FactCheckToolsService

API Fact Check Tools

L'API Fact Check Tools fornisce l'accesso programmatico alle funzionalità offerte tramite il frontend di Google Fact Check Tools all'indirizzo https://g.co/factchecktools.

Le API attualmente disponibili sono:

  • Ricerca di affermazioni verificate (fornita tramite il frontend di Fact Check Explorer).
  • Ricerca di affermazioni verificate tramite fact checking per immagine (fornita tramite il frontend di Fact Check Explorer).

  • Interfaccia CRUD per il markup ClaimReview su una pagina (fornita tramite il frontend dello strumento di Fact Check Markup).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Crea il markup ClaimReview su una pagina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/factchecktools
DeleteClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Elimina tutto il markup ClaimReview in una pagina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/factchecktools
FactCheckedClaimImageSearch

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Cerca le affermazioni sottoposte a fact checking utilizzando un'immagine come query.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Cerca tra le affermazioni sottoposte a fact checking.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Visualizza tutto il markup ClaimReview di una pagina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/factchecktools
ListClaimReviewMarkupPages

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Elenca le pagine di markup ClaimReview per un URL specifico o per un'organizzazione.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/factchecktools
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Aggiornamento di tutto il markup ClaimReview di una pagina

Tieni presente che si tratta di un aggiornamento completo. Per conservare il markup ClaimReview esistente in una pagina, esegui prima un'operazione Get, poi modifica il markup restituito e infine chiama Update con l'intero markup ClaimReview come corpo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/factchecktools

Richiedi

Informazioni sulla rivendicazione.

Campi
text

string

Il testo della rivendicazione. Ad esempio, "La criminalità è raddoppiata negli ultimi due anni".
claimant

string

Una persona o un'organizzazione che presenta la rivendicazione. Ad esempio, "Mario Rossi".
claim_date

Timestamp

La data in cui è stata presentata la rivendicazione.
claim_review[]

ClaimReview

Una o più revisioni di questa affermazione (ovvero un articolo di fact checking).

ClaimAuthor

Informazioni sull'autore della rivendicazione.

Campi
name

string

Una persona o un'organizzazione che presenta la rivendicazione. Ad esempio, "Mario Rossi".
Corrisponde a ClaimReview.itemReviewed.author.name.
job_title

string

Corrisponde a ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Corrisponde a ClaimReview.itemReviewed.author.image.
same_as

string

Corrisponde a ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informazioni sulla valutazione della rivendicazione.

Campi
textual_rating

string

La valutazione di veridicità sotto forma di breve parola o frase leggibile da una persona.
Corrisponde a ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Una valutazione numerica di questa dichiarazione, nell'intervallo compreso tra worstRating e bestRating inclusi.
Corrisponde a ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Per le valutazioni numeriche, il peggior valore possibile nella scala dal peggiore al migliore.
Corrisponde a ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Per le valutazioni numeriche, il miglior valore possibile nella scala dal peggiore al migliore.
Corrisponde a ClaimReview.reviewRating.bestRating.
rating_explanation

string

Corrisponde a ClaimReview.reviewRating.ratingExplanation.
image_url

string

Corrisponde a ClaimReview.reviewRating.image.

ClaimReview

Informazioni su una revisione della rivendicazione.

Campi
publisher

Publisher

Il publisher di questa revisione della rivendicazione.
url

string

L'URL di questa revisione della rivendicazione.
title

string

Il titolo di questa revisione della rivendicazione, se può essere determinato.
review_date

Timestamp

La data in cui è stata esaminata la rivendicazione.
textual_rating

string

Valutazione testuale. Ad esempio, "Per lo più falso".
language_code

string

La lingua in cui è stata scritta la recensione. Ad esempio, "en" o "de".

ClaimReviewAuthor

Informazioni sull'autore della revisione della dichiarazione.

Campi
name

string

Nome dell'organizzazione che pubblica il fact check.
Corrisponde a ClaimReview.author.name.
image_url

string

Corrisponde a ClaimReview.author.image.

ClaimReviewMarkup

Campi per un singolo elemento ClaimReview. Ad eccezione dei messaggi secondari che raggruppano i campi, ciascuno di questi campi corrisponde a quelli in https://schema.org/ClaimReview. Elenco la mappatura precisa per ogni campo.

Campi
url

string

Questo campo è facoltativo e verrà impostato come URL della pagina per impostazione predefinita. Forniamo questo campo per consentirti di ignorare il valore predefinito, ma l'unico override consentito è l'URL della pagina più un link di ancoraggio facoltativo ("salto di pagina").
corrisponde a ClaimReview.url
claim_reviewed

string

Un breve riepilogo della dichiarazione oggetto di valutazione.
Corrisponde a ClaimReview.claimReviewed.
claim_date

string

La data in cui la dichiarazione è stata resa pubblica o è diventata di pubblico dominio.
Corrisponde a ClaimReview.itemReviewed.datePublished.
claim_location

string

La posizione in cui è stata effettuata questa rivendicazione.
Corrisponde a ClaimReview.itemReviewed.name.
claim_first_appearance

string

Un link a un'opera in cui compare per la prima volta questa dichiarazione.
Corrisponde a ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Un elenco di link a opere in cui compare questa dichiarazione, oltre a quella specificata in claim_first_appearance.
Corrisponde a ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Informazioni sull'autore di questa rivendicazione.
rating

ClaimRating

Informazioni sulla valutazione di questa revisione della rivendicazione.

ClaimReviewMarkupPage

Contiene una o più istanze del markup ClaimReview per una pagina web.

Campi
name

string

Il nome di questa risorsa della pagina di markup ClaimReview, nel formato pages/{page_id}. Ad eccezione delle richieste di aggiornamento, questo campo è di sola output e non deve essere impostato dall'utente.
page_url

string

L'URL della pagina associata a questo markup ClaimReview. Sebbene ogni singolo ClaimReview abbia il proprio campo URL, a livello semantico si tratta di un campo a livello di pagina e ogni ClaimReview in questa pagina utilizzerà questo valore, a meno che non venga sostituito singolarmente.
corrisponde a ClaimReview.url
publish_date

string

La data di pubblicazione del fact checking. Analogamente all'URL, a livello semantico questo è un campo a livello di pagina e ogni ClaimReview in questa pagina conterrà lo stesso valore.
corrisponde a ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Informazioni sull'autore di questa revisione della rivendicazione. Analogamente a quanto sopra, questi sono campi a livello di pagina e ogni ClaimReview in questa pagina conterrà gli stessi valori.
claim_review_markups[]

ClaimReviewMarkup

Un elenco di singole revisioni delle rivendicazioni per questa pagina. Ogni elemento dell'elenco corrisponde a un elemento ClaimReview.
version_id

string

L'ID versione di questo markup. Ad eccezione delle richieste di aggiornamento, questo campo è di sola output e non deve essere impostato dall'utente.

CreateClaimReviewMarkupPageRequest

Richiesta di creazione del markup ClaimReview su una pagina.

Campi
claim_review_markup_page

ClaimReviewMarkupPage

Il markup ClaimReview da creare per questa pagina. Se viene fornita una versione più canonica dell'URL della pagina, utilizzeremo questa.

DeleteClaimReviewMarkupPageRequest

Richiesta di eliminazione di tutti i markup ClaimReview in una pagina.

Campi
name

string

Il nome della risorsa da eliminare, nel formato pages/{page_id}.

FactCheckedClaimImageSearchRequest

Richiesta di ricerca di affermazioni sottoposte a fact checking per immagine.

Campi
image_uri

string

Obbligatorio. L'URI dell'immagine di origine. Deve essere un URL HTTP/HTTPS di un'immagine accessibile pubblicamente.

Quando recupera le immagini dagli URL HTTP/HTTPS, Google non può garantire che la richiesta venga completata. La richiesta potrebbe non andare a buon fine se l'host specificato la rifiuta (ad es. a causa della limitazione delle richieste o della prevenzione di attacchi DoS) o se Google limita le richieste al sito per prevenire abusi. Non devi fare affidamento su immagini ospitate esternamente per le applicazioni di produzione.
language_code

string

(Facoltativo) Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Può essere utilizzato per limitare i risultati in base alla lingua, anche se al momento non prendiamo in considerazione la regione.
page_size

int32

(Facoltativo) La dimensione della paginazione. Restituiremo fino a quel numero di risultati. Se non impostato, il valore predefinito è 10.
page_token

string

(Facoltativo) Il token di impaginazione. Puoi fornire il valore next_page_token restituito da una precedente richiesta List, se presente, per ottenere la pagina successiva. Tutti gli altri campi devono avere gli stessi valori della richiesta precedente.
offset

int32

(Facoltativo) Un numero intero che specifica l'offset corrente (ovvero la posizione del risultato iniziale) nei risultati di ricerca. Questo campo viene preso in considerazione solo se page_token non è impostato. Ad esempio, 0 significa restituire i risultati a partire dal primo risultato corrispondente, mentre 10 significa restituire i risultati a partire dall'undicesimo.

FactCheckedClaimImageSearchResponse

Risposta alla ricerca di affermazioni sottoposte a fact checking per immagine.

Campi
results[]

Result

L'elenco delle rivendicazioni e tutte le informazioni associate.
next_page_token

string

Il token di paginazione successivo nella risposta di ricerca. Deve essere utilizzato come page_token per la seguente richiesta. Un valore vuoto indica che non ci sono altri risultati.

Risultato

Una rivendicazione e le informazioni associate.

Campi
claim

Claim

Una rivendicazione che corrisponde alla query.

FactCheckedClaimSearchRequest

Richiesta di ricerca tra le affermazioni sottoposte a fact checking.

Campi
query

string

Stringa di query testuale. Obbligatorio a meno che non sia specificato review_publisher_site_filter.
language_code

string

Il codice lingua BCP-47, ad esempio "en-US" o "sr-Latn". Può essere utilizzato per limitare i risultati in base alla lingua, anche se al momento non prendiamo in considerazione la regione.
review_publisher_site_filter

string

Il sito dell'editore della recensione in base al quale filtrare i risultati, ad esempio nytimes.com.
max_age_days

int32

L'età massima dei risultati di ricerca restituiti, in giorni. L'età viene determinata in base alla data della rivendicazione o alla data della revisione, a seconda di quale sia più recente.
page_size

int32

La dimensione della paginazione. Restituiremo fino a quel numero di risultati. Se non impostato, il valore predefinito è 10.
page_token

string

Il token di impaginazione. Puoi fornire il valore next_page_token restituito da una precedente richiesta List, se presente, per ottenere la pagina successiva. Tutti gli altri campi devono avere gli stessi valori della richiesta precedente.
offset

int32

Un numero intero che specifica l'offset corrente (ovvero la posizione del risultato iniziale) nei risultati di ricerca. Questo campo viene preso in considerazione solo se page_token non è impostato. Ad esempio, 0 significa restituire i risultati a partire dal primo risultato corrispondente, mentre 10 significa restituire i risultati a partire dall'undicesimo.

FactCheckedClaimSearchResponse

Risposta alla ricerca di affermazioni sottoposte a fact checking.

Campi
claims[]

Claim

L'elenco delle rivendicazioni e tutte le informazioni associate.
next_page_token

string

Il token di paginazione successivo nella risposta di ricerca. Deve essere utilizzato come page_token per la seguente richiesta. Un valore vuoto indica che non ci sono altri risultati.

GetClaimReviewMarkupPageRequest

Richiesta di recupero del markup ClaimReview su una pagina.

Campi
name

string

Il nome della risorsa da ottenere, nel formato pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Richiesta di markup ClaimReview.

Campi
url

string

L'URL da cui ottenere il markup ClaimReview. Verrà visualizzato al massimo un risultato. Se il markup è associato a una versione più canonica dell'URL fornito, restituiremo quell'URL. Non può essere specificato insieme a un'organizzazione.
organization

string

L'organizzazione per cui vogliamo recuperare i markup. Ad esempio, "site.com". Non può essere specificato insieme a un URL.
page_size

int32

La dimensione della paginazione. Restituiremo fino a quel numero di risultati. Se non impostato, il valore predefinito è 10. Non ha alcun effetto se viene richiesto un URL.
page_token

string

Il token di impaginazione. Puoi fornire il valore next_page_token restituito da una precedente richiesta List, se presente, per ottenere la pagina successiva. Tutti gli altri campi devono avere gli stessi valori della richiesta precedente.
offset

int32

Un numero intero che specifica l'offset corrente (ovvero la posizione del risultato iniziale) nei risultati di ricerca. Questo campo viene preso in considerazione solo se page_token non è impostato e se la richiesta non riguarda un URL specifico. Ad esempio, 0 significa restituire i risultati a partire dal primo risultato corrispondente, mentre 10 significa restituire i risultati a partire dall'undicesimo.

ListClaimReviewMarkupPagesResponse

Risposta dal markup della scheda ClaimReview.

Campi
claim_review_markup_pages[]

ClaimReviewMarkupPage

L'elenco dei risultati delle pagine con markup ClaimReview.
next_page_token

string

Il token di paginazione successivo nella risposta di ricerca. Deve essere utilizzato come page_token per la seguente richiesta. Un valore vuoto indica che non ci sono altri risultati.

Publisher

Informazioni sull'editore.

Campi
name

string

Il nome di questo editore. Ad esempio, "Awesome Fact Checks".
site

string

Nome del sito a livello di host, senza il protocollo o il prefisso "www". Ad esempio, "awesomefactchecks.com". Il valore di questo campo si basa esclusivamente sull'URL di revisione della rivendicazione.

UpdateClaimReviewMarkupPageRequest

Richiesta di aggiornamento di tutto il markup ClaimReview di una pagina.

Campi
claim_review_markup_page

ClaimReviewMarkupPage

Il markup ClaimReview aggiornato per questa pagina. Le richieste di aggiornamento devono specificare sia il nome della risorsa sia l'ID versione della risorsa da aggiornare. Se l'ID versione specificato non corrisponde all'ID versione dell'ultimo markup (il che può accadere se il markup è stato modificato dall'ultima lettura), questa richiesta non andrà a buon fine. Inoltre, gli aggiornamenti non devono modificare l'URL della pagina. Per modificare l'URL del markup, elimina il markup precedente e ricrealo con il nuovo URL.