Package google.factchecking.factchecktools.v1alpha1

Indice

Servizio FactCheckTools

API Fact Check Tools

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

Le API attuali disponibili sono:

  • Dichiarazione di Fact Check Check (fornita tramite il frontend di Fact Check Explorer).

  • Interfaccia CRUD per il markup ClaimReview in una pagina (fornita tramite il frontend dello strumento di fact check).

CreazioneRivendicaPaginaMarkup

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Crea il markup ClaimReview in una pagina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
EliminazioneRivendicaPaginaMarkup

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/userinfo.email
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Cerca tra le affermazioni con fact check,
Pagina GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Ottieni tutto il markup ClaimReview in una pagina.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email
PagineListReviewReviewMarkPagine

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/userinfo.email
Pagina di aggiornamento della richiesta di revisione

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Aggiornamento per tutto il markup ClaimReview in una pagina

Tieni presente che questo è un aggiornamento completo. Per conservare il markup ClaimReview esistente su una pagina, esegui prima un'operazione Get, quindi modifica il markup restituito e infine chiama Aggiorna con l'intero markup ClaimReview come corpo.

Ambiti di autorizzazione

Richiede il seguente ambito OAuth:

  • https://www.googleapis.com/auth/userinfo.email

Rivendicazione

Informazioni sulla dichiarazione.

Campi
text

string

Il testo della rivendicazione. Ad esempio, "Crime è raddoppiato negli ultimi due anni".

claimant

string

Una persona o un'organizzazione che dichiara la dichiarazione. Ad esempio, "Mario Rossi".

claim_date

Timestamp

La data in cui è stata effettuata la rivendicazione.

claim_review[]

ClaimReview

Una o più recensioni di questa dichiarazione (vale a dire un articolo di fact checking).

Autore rivendicazione

Informazioni sull'autore della rivendicazione.

Campi
name

string

Una persona o un'organizzazione che dichiara la dichiarazione. 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.

Classificazione rivendicazione

Informazioni sulla valutazione della rivendicazione.

Campi
textual_rating

string

La valutazione di veridicità come parola o frase breve leggibile.
corrisponde a ClaimReview.reviewRating.alternateName.

rating_value

Int32Value

Una valutazione numerica di questa dichiarazione, nell'intervallo compreso tra peggioreRating 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 sull'esame di una rivendicazione.

Campi
publisher

Publisher

Il publisher di questa verifica delle rivendicazioni.

url

string

L'URL di questa verifica delle dichiarazioni.

title

string

Il titolo dell'esame della rivendicazione, se possibile.

review_date

Timestamp

La data in cui la rivendicazione è stata esaminata.

textual_rating

string

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

language_code

string

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

ClaimReviewAuthor

Informazioni sull'autore della verifica delle rivendicazioni.

Campi
name

string

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

image_url

string

Corrisponde a ClaimReview.author.image.

Rivendicazione markup

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

Campi
url

string

Questo campo è facoltativo e il valore predefinito sarà l'URL della pagina. Forniamo questo campo per consentirti di sostituire il valore predefinito, ma l'unica sostituzione consentita è 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 località in cui è stata effettuata la rivendicazione.
corrisponde a ClaimReview.itemReviewed.name.

claim_first_appearance

string

Un link a un'opera in cui questa rivendicazione viene visualizzata per la prima volta.
corrisponde a ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Un elenco di link alle opere in cui compare la rivendicazione, 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 rivendicazione.

Pagina ClaimReviewMarkup

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, sotto forma di pages/{page_id}. Fatta eccezione per le richieste di aggiornamento, questo campo è di tipo esclusivo e non deve essere impostato dall'utente.

page_url

string

L'URL della pagina associata a questo markup ClaimReview. Sebbene ogni singolo ClaimReview abbia un proprio campo URL, semanticamente 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 check. Analogamente all'URL, semanticamente si tratta di un campo a livello di pagina e ogni ClaimReview di questa pagina conterrà lo stesso valore.
corrisponde a ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Informazioni sull'autore di questa verifica delle dichiarazioni. Analogamente al funzionamento precedente, semanticamente si tratta di campi a livello di pagina e ogni ClaimReview di questa pagina conterrà gli stessi valori.

claim_review_markups[]

ClaimReviewMarkup

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

version_id

string

L'ID versione di questo markup. Fatta eccezione per le richieste di aggiornamento, questo campo è di tipo esclusivo e non deve essere impostato dall'utente.

CreaRivendicaRecensioneMarkupPaginaRichiesta

Richiesta di creazione di un markup ClaimReview su una pagina.

Campi
claim_review_markup_page

ClaimReviewMarkupPage

Il markup ClaimReview da creare per questa pagina. Se è disponibile una versione più canonica dell'URL della pagina, la utilizzeremo noi.

EliminaRivendicaRecensioneMarkupPaginaRichiesta

Richiesta di eliminazione del markup ClaimReview in una pagina.

Campi
name

string

Il nome della risorsa da eliminare, sotto forma di pages/{page_id}.

FactCheckedClaimSearchRequest

Richiesta di ricerca di affermazioni con fact check.

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, sebbene al momento non consideriamo la regione.

review_publisher_site_filter

string

Il sito del publisher di recensioni per 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 della revisione, a seconda della data più recente.

page_size

int32

Le dimensioni dell'impaginazione. Ti restituiremo fino a così tanti risultati. Se non viene impostato, il valore predefinito è 10.

page_token

string

Il token di impaginazione. Per ottenere la pagina successiva, puoi fornire next_page_token, restituito da una richiesta Lista precedente. Tutti gli altri campi devono avere gli stessi valori della richiesta precedente.

offset

int32

Un numero intero che specifica l'offset attuale (ovvero la posizione iniziale dei risultati) 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 e 10 significa restituire dall'11° risultato.

FactCheckedClaimSearchResponse

Risposta dalla ricerca di affermazioni con fact check.

Campi
claims[]

Claim

L'elenco delle rivendicazioni e tutte le informazioni associate.

next_page_token

string

Il successivo token di impaginazione nella risposta di ricerca. Dovrebbe essere utilizzato come page_token per la richiesta seguente. Se il valore è vuoto non significa più risultati.

RichiediRivendicaRecensioneMarkupPaginaRichiesta

Richiesta di inserimento del markup ClaimReview in una pagina.

Campi
name

string

Il nome della risorsa da ricevere, sotto forma di pages/{page_id}.

ListClaimReviewMarkupPageRequest

Richiesta di inserimento del markup ClaimReview.

Campi
url

string

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

organization

string

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

page_size

int32

Le dimensioni dell'impaginazione. Ti restituiremo fino a così tanti risultati. Se non viene impostato, il valore predefinito è 10. Non ha effetto se viene richiesto un URL.

page_token

string

Il token di impaginazione. Per ottenere la pagina successiva, puoi fornire next_page_token, restituito da una richiesta Lista precedente. Tutti gli altri campi devono avere gli stessi valori della richiesta precedente.

offset

int32

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

Risposta ListReviewReviewMarkuppagesResponse

Risposta dalla scheda del markup ClaimReview.

Campi
claim_review_markup_pages[]

ClaimReviewMarkupPage

L'elenco di risultati di pagine con il markup ClaimReview.

next_page_token

string

Il successivo token di impaginazione nella risposta di ricerca. Dovrebbe essere utilizzato come page_token per la richiesta seguente. Se il valore è vuoto non significa più risultati.

Publisher

Informazioni sull'editore.

Campi
name

string

Il nome di questo publisher. Ad esempio, "Fantastici fact check".

site

string

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

AggiornamentoRichiedi Recensione Markup Richiesta

Richiesta di aggiornamento di tutti i markup ClaimReview in 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), la 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.