Package google.factchecking.factchecktools.v1alpha1

Index

FactCheckToolsService

API Fact Check Tools

L'API Fact Check Tools permet d'accéder de manière programmatique aux fonctionnalités fournies par l'interface utilisateur des outils de fact-checking Google à l'adresse https://g.co/factchecktools.

Voici les API actuellement disponibles :

  • Recherche de déclarations vérifiées (fournie via l'interface utilisateur Fact Check Explorer)
  • Recherche de déclarations vérifiées par image (fournie via l'interface utilisateur de Fact Check Explorer)

  • Interface CRUD pour le balisage ClaimReview sur une page (fournie par l'interface utilisateur de Fact Check Markup Tool).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Créez un balisage ClaimReview sur une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Supprimez tout le balisage ClaimReview d'une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Recherchez des affirmations vérifiées à l'aide d'une image comme requête.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Recherchez des affirmations vérifiées.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Obtenez tout le balisage ClaimReview d'une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Lister les pages de balisage ClaimReview pour une URL ou une organisation spécifiques.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Mettre à jour tous les balisages ClaimReview d'une page

Notez qu'il s'agit d'une mise à jour complète. Pour conserver le balisage ClaimReview existant sur une page, commencez par effectuer une opération Get, puis modifiez le balisage renvoyé. Enfin, appelez Update avec l'intégralité du balisage ClaimReview comme corps.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Revendication

Informations sur la réclamation.

Champs
text

string

Texte de la réclamation. Par exemple : "La criminalité a doublé au cours des deux dernières années."
claimant

string

Personne ou organisation qui fait la déclaration. Par exemple, "Jean Dupont".
claim_date

Timestamp

Date à laquelle la réclamation a été déposée.
claim_review[]

ClaimReview

Une ou plusieurs vérifications de cette affirmation (à savoir, un article de fact-checking).

ClaimAuthor

Informations sur l'auteur de la déclaration.

Champs
name

string

Personne ou organisation qui fait la déclaration. Par exemple, "Jean Dupont".
correspond à ClaimReview.itemReviewed.author.name.
job_title

string

Correspond à ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Correspond à ClaimReview.itemReviewed.author.image.
same_as

string

Correspond à ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informations sur la classification de la réclamation.

Champs
textual_rating

string

Évaluation de la véracité sous la forme d'un mot ou d'une phrase courte intelligible.
correspond à ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Note numérique de cette déclaration, dans une plage allant de worstRating à bestRating (inclus).
correspond à ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Pour les évaluations numériques, il s'agit de la pire valeur possible sur une échelle allant du pire au meilleur.
correspond à ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Pour les évaluations numériques, il s'agit de la meilleure valeur possible sur une échelle allant du pire au meilleur.
correspond à ClaimReview.reviewRating.bestRating.
rating_explanation

string

Correspond à ClaimReview.reviewRating.ratingExplanation.
image_url

string

Correspond à ClaimReview.reviewRating.image.

ClaimReview

Informations sur l'examen d'une réclamation.

Champs
publisher

Publisher

Éditeur de cet examen de la revendication.
url

string

URL de cet examen de la réclamation.
title

string

Titre de l'examen de la réclamation, s'il peut être déterminé.
review_date

Timestamp

Date à laquelle la revendication a été examinée.
textual_rating

string

Classification textuelle. Par exemple, "Plutôt faux".
language_code

string

Langue dans laquelle cet avis a été rédigé. Par exemple, "en" ou "de".

ClaimReviewAuthor

Informations sur l'auteur de l'examen de la réclamation.

Champs
name

string

Nom de l'organisation qui publie le contenu de fact-checking.
correspond à ClaimReview.author.name.
image_url

string

Correspond à ClaimReview.author.image.

ClaimReviewMarkup

Champs pour un élément ClaimReview individuel. À l'exception des sous-messages qui regroupent des champs, chacun de ces champs correspond à ceux de https://schema.org/ClaimReview. Nous indiquons le mappage précis pour chaque champ.

Champs
url

string

Ce champ est facultatif et la valeur par défaut est l'URL de la page. Nous fournissons ce champ pour vous permettre de remplacer la valeur par défaut, mais la seule modification autorisée est l'URL de la page plus un lien d'ancrage facultatif (saut de page).
correspond à ClaimReview.url
claim_reviewed

string

Bref résumé de la déclaration faisant l'objet de l'évaluation.
correspond à ClaimReview.claimReviewed.
claim_date

string

Date à laquelle la déclaration a été faite ou est entrée dans le discours public.
correspond à ClaimReview.itemReviewed.datePublished.
claim_location

string

Lieu où cette revendication a été faite.
correspond à ClaimReview.itemReviewed.name.
claim_first_appearance

string

Lien vers une œuvre dans laquelle cette déclaration apparaît en premier.
correspond à ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Liste de liens vers les œuvres dans lesquelles cette affirmation apparaît, en dehors de celle spécifiée dans claim_first_appearance.
correspond à ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Informations sur l'auteur de cette revendication.
rating

ClaimRating

Informations sur l'évaluation de cet examen de la réclamation.

ClaimReviewMarkupPage

Contient une ou plusieurs instances de balisage ClaimReview pour une page Web.

Champs
name

string

Nom de la ressource de page de balisage ClaimReview, au format pages/{page_id}. À l'exception des demandes de mise à jour, ce champ est en sortie seule et ne doit pas être défini par l'utilisateur.
page_url

string

URL de la page associée à ce balisage ClaimReview. Bien que chaque ClaimReview individuel dispose de son propre champ d'URL, il s'agit sémantiquement d'un champ au niveau de la page. Chaque ClaimReview de cette page utilisera cette valeur, sauf si elle est remplacée individuellement.
correspond à ClaimReview.url
publish_date

string

Date à laquelle le contenu de fact-checking a été publié. Comme pour l'URL, il s'agit sémantiquement d'un champ au niveau de la page, et chaque ClaimReview de cette page contiendra la même valeur.
correspond à ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Informations sur l'auteur de cet examen de la réclamation. Comme ci-dessus, il s'agit de champs au niveau de la page. Chaque ClaimReview de cette page contiendra les mêmes valeurs.
claim_review_markups[]

ClaimReviewMarkup

Liste des examens de revendications individuels pour cette page. Chaque élément de la liste correspond à un élément ClaimReview.
version_id

string

ID de version de ce balisage. À l'exception des demandes de mise à jour, ce champ est en sortie seule et ne doit pas être défini par l'utilisateur.

CreateClaimReviewMarkupPageRequest

Demande de création d'un balisage ClaimReview sur une page.

Champs
claim_review_markup_page

ClaimReviewMarkupPage

Le balisage ClaimReview à créer pour cette page. Si une version plus canonique de l'URL de la page fournie existe, nous l'utiliserons à la place.

DeleteClaimReviewMarkupPageRequest

Demande de suppression de tout le balisage ClaimReview sur une page.

Champs
name

string

Nom de la ressource à supprimer, au format pages/{page_id}.

FactCheckedClaimImageSearchRequest

Demande de recherche d'affirmations vérifiées par image.

Champs
image_uri

string

Obligatoire. URI de l'image source. Il doit s'agir d'une URL HTTP/HTTPS d'image accessible au public.

Lorsque les images sont récupérées par le biais d'URL HTTP/HTTPS, Google ne peut pas garantir que la requête sera traitée. La requête peut échouer si l'hébergeur la rejette (par exemple, en raison de mesures de limitation du trafic ou de protection contre les attaques DoS) ou si Google limite l'accès au site afin d'empêcher tout abus. Vos applications de production ne doivent pas dépendre d'images hébergées en externe.
language_code

string

Facultatif. Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Permet de limiter les résultats par langue, mais nous ne tenons pas compte de la région pour le moment.
page_size

int32

Facultatif. Taille de la pagination. Nous renverrons jusqu'à ce nombre de résultats. Si cette clause n'est pas définie, la valeur par défaut est 10.
page_token

string

Facultatif. Jeton de pagination. Vous pouvez fournir le next_page_token renvoyé par une requête List précédente, le cas échéant, afin d'obtenir la page suivante. Tous les autres champs doivent avoir les mêmes valeurs que dans la requête précédente.
offset

int32

Facultatif. Valeur entière spécifiant le décalage actuel (c'est-à-dire l'emplacement du résultat de départ) dans les résultats de recherche. Ce champ n'est pris en compte que si page_token n'est pas spécifié. Par exemple, la valeur 0 signifie que les résultats doivent commencer par le premier résultat correspondant, tandis que la valeur 10 signifie qu'ils doivent commencer par le 11e résultat.

FactCheckedClaimImageSearchResponse

Réponse à une recherche d'affirmations vérifiées par image.

Champs
results[]

Result

Liste des revendications et de toutes les informations associées.
next_page_token

string

Le prochain jeton de pagination dans la réponse Search. Il devrait être utilisé comme page_token pour la requête suivante. Une valeur vide signifie qu'il n'y a plus de résultats.

Résultat

Une revendication et les informations associées.

Champs
claim

Claim

Affirmation correspondant à la requête.

FactCheckedClaimSearchRequest

Demande de recherche dans les affirmations vérifiées.

Champs
query

string

Chaîne de requête textuelle. Obligatoire, sauf si review_publisher_site_filter est spécifié.
language_code

string

Le code de langue BCP-47, tel que "en-US" ou "sr-Latn". Permet de limiter les résultats par langue, mais nous ne tenons pas compte de la région pour le moment.
review_publisher_site_filter

string

Site de l'éditeur d'avis selon lequel filtrer les résultats (par exemple, nytimes.com).
max_age_days

int32

Âge maximal des résultats de recherche renvoyés, en jours. L'âge est déterminé par la date de la réclamation ou la date de l'avis, selon la plus récente.
page_size

int32

Taille de la pagination. Nous renverrons jusqu'à ce nombre de résultats. Si cette clause n'est pas définie, la valeur par défaut est 10.
page_token

string

Jeton de pagination. Vous pouvez fournir le next_page_token renvoyé par une requête List précédente, le cas échéant, afin d'obtenir la page suivante. Tous les autres champs doivent avoir les mêmes valeurs que dans la requête précédente.
offset

int32

Valeur entière spécifiant le décalage actuel (c'est-à-dire l'emplacement du résultat de départ) dans les résultats de recherche. Ce champ n'est pris en compte que si page_token n'est pas spécifié. Par exemple, la valeur 0 signifie que les résultats doivent commencer par le premier résultat correspondant, tandis que la valeur 10 signifie qu'ils doivent commencer par le 11e résultat.

FactCheckedClaimSearchResponse

Réponse à la recherche d'affirmations vérifiées.

Champs
claims[]

Claim

Liste des revendications et de toutes les informations associées.
next_page_token

string

Le prochain jeton de pagination dans la réponse Search. Il devrait être utilisé comme page_token pour la requête suivante. Une valeur vide signifie qu'il n'y a plus de résultats.

GetClaimReviewMarkupPageRequest

Requête permettant d'obtenir le balisage ClaimReview sur une page.

Champs
name

string

Nom de la ressource à obtenir, au format pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Demande de balisage ClaimReview pour une fiche.

Champs
url

string

URL à partir de laquelle obtenir le balisage ClaimReview. Il n'y aura qu'un seul résultat. Si le balisage est associé à une version plus canonique de l'URL fournie, nous renverrons cette URL à la place. Ne peut pas être spécifié avec une organisation.
organization

string

Organisation pour laquelle nous souhaitons récupérer les balises. (par exemple, "site.com"). Ne peut pas être spécifié avec une URL.
page_size

int32

Taille de la pagination. Nous renverrons jusqu'à ce nombre de résultats. Si cette clause n'est pas définie, la valeur par défaut est 10. N'a aucun effet si une URL est demandée.
page_token

string

Jeton de pagination. Vous pouvez fournir le next_page_token renvoyé par une requête List précédente, le cas échéant, afin d'obtenir la page suivante. Tous les autres champs doivent avoir les mêmes valeurs que dans la requête précédente.
offset

int32

Valeur entière spécifiant le décalage actuel (c'est-à-dire l'emplacement du résultat de départ) dans les résultats de recherche. Ce champ n'est pris en compte que si page_token n'est pas défini et si la requête ne concerne pas une URL spécifique. Par exemple, la valeur 0 signifie que les résultats doivent commencer par le premier résultat correspondant, tandis que la valeur 10 signifie qu'ils doivent commencer par le 11e résultat.

ListClaimReviewMarkupPagesResponse

Réponse du balisage de la fiche ClaimReview.

Champs
claim_review_markup_pages[]

ClaimReviewMarkupPage

Liste des pages de résultats du balisage ClaimReview.
next_page_token

string

Le prochain jeton de pagination dans la réponse Search. Il devrait être utilisé comme page_token pour la requête suivante. Une valeur vide signifie qu'il n'y a plus de résultats.

Éditeur

Informations sur l'éditeur.

Champs
name

string

Nom de cet éditeur. Par exemple, "Awesome Fact Checks".
site

string

Nom du site au niveau de l'hôte, sans le protocole ni le préfixe "www". Par exemple, "awesomefactchecks.com". La valeur de ce champ est basée uniquement sur l'URL d'examen de la revendication.

UpdateClaimReviewMarkupPageRequest

Requête de mise à jour de tout le balisage ClaimReview d'une page.

Champs
claim_review_markup_page

ClaimReviewMarkupPage

Balisage ClaimReview mis à jour pour cette page. Les requêtes de mise à jour doivent spécifier à la fois le nom et l'ID de version de la ressource à mettre à jour. Si l'ID de version spécifié ne correspond pas à l'ID de version du dernier balisage (ce qui peut se produire si le balisage a été modifié depuis la dernière lecture), cette requête échouera. Les mises à jour ne doivent pas non plus modifier l'URL de la page. Pour modifier l'URL du balisage, supprimez l'ancien balisage et recréez-le avec la nouvelle URL.