Package google.factchecking.factchecktools.v1alpha1

Index

Service de fact-checking

API Fact-Check Tools

L'API Fact Check Tools fournit un accès programmatique aux fonctionnalités fournies via l'interface Google Fact Check Tools à l'adresse https://g.co/factchecktools.

Les API actuellement disponibles sont les suivantes:

  • Recherche de faits effectuée par l'interface de l'explorateur de fact-checking

  • Interface CRUD pour le balisage ClaimReview sur une page (fournie via l'interface de l'outil de balisage Fact-checking).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Créez le balisage ClaimReview sur une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Supprimez le balisage ClaimReview sur une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

  • https://www.googleapis.com/auth/userinfo.email
Recherche de faits vérifiés

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Effectuez des recherches dans des déclarations vérifiées.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Obtenir le balisage ClaimReview sur une page.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Répertoriez les pages de balisage ClaimReview pour une URL spécifique ou pour une organisation.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Mettre à jour le balisage ClaimReview sur une page

Notez qu'il s'agit d'une mise à jour complète. Pour conserver le balisage ClaimReview existant sur une page, effectuez d'abord une opération "Get", puis modifiez le balisage renvoyé. Enfin, appelez la méthode "Update" en insérant tout le balisage ClaimReview dans le corps.

Champs d'application des autorisations

Requiert le niveau d'accès OAuth suivant :

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

Demander

Informations sur la revendication.

Champs
text

string

Texte de la revendication. Par exemple, le crime a doublé au cours des deux dernières années.

claimant

string

Personne ou organisation qui indique la déclaration. Exemple : "Jean Dupont".

claim_date

Timestamp

Date de la revendication.

claim_review[]

ClaimReview

Un ou plusieurs avis sur cette déclaration (par exemple, un article de fact-checking)

Auteur de la revendication

Informations sur l'auteur de la revendication.

Champs
name

string

Personne ou organisation qui indique la déclaration. 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.

Revendication de revendication

Informations sur la note associée à la revendication.

Champs
textual_rating

string

Évaluation de la véracité en tant que mot ou expression courte intelligible.
correspond à ClaimReview.reviewRating.alternateName.

rating_value

Int32Value

Note numérique de cette déclaration, comprise dans la plage worstRating — bestRating inclusive.
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 revendication.

Champs
publisher

Publisher

Éditeur de cette revendication.

url

string

URL de cette réclamation.

title

string

Titre de l'examen de la revendication, s'il est possible de le déterminer.

review_date

Timestamp

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

textual_rating

string

Note textuelle. Par exemple, "principalement faux".

language_code

string

Langue de l'avis. Par exemple, "en" ou "de".

Auteur de l'avis de revendication

Informations sur l'auteur de l'examen de la revendication.

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 d'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 affiche par défaut l'URL de la page. Ce champ est disponible pour que vous puissiez remplacer la valeur par défaut, mais le seul remplacement autorisé est l'URL de la page et 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ù la revendication a été effectuée
correspond à ClaimReview.itemReviewed.name.

claim_first_appearance

string

Lien vers l'œuvre dans laquelle la revendication apparaît.
correspond à ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Liste des liens vers les œuvres dans lesquelles cette revendication apparaît, à l'exception 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 réclamation.

rating

ClaimRating

Informations sur la note associée à cette vérification.

ClaimReviewMarkupPage

Contient une ou plusieurs occurrences du balisage ClaimReview pour une page Web.

Champs
name

string

Nom de cette ressource de page de balisage ClaimReview, sous la forme pages/{page_id}. À l'exception des requêtes de mise à jour, ce champ est en sortie uniquement 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 possè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 vous la remplacez individuellement.
correspond à ClaimReview.url

publish_date

string

Date de publication du contenu de fact-checking. Comme pour l'URL, il s'agit sémantiquement d'un champ au niveau de la page. Chaque ClaimReview de cette page contiendra la même valeur.
correspond à ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Informations sur l'auteur de cette déclaration. Comme ci-dessus, sémantiquement, il s'agit de champs au niveau de la page, et chaque ClaimReview de cette page contiendra les mêmes valeurs.

claim_review_markups[]

ClaimReviewMarkup

Liste d'examens de revendications individuelles 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 requêtes de mise à jour, ce champ est en sortie uniquement et ne doit pas être défini par l'utilisateur.

CreateClaimReviewMarkupPageRequest

Requête de création d'un balisage ClaimReview sur une page.

Champs
claim_review_markup_page

ClaimReviewMarkupPage

Balisage ClaimReview à créer pour cette page. Si une version plus canonique de l'URL de la page est fournie, nous utiliserons celle-ci.

DeleteClaimReviewMarkupPageRequest

Requête permettant de supprimer l'intégralité du balisage ClaimReview sur une page.

Champs
name

string

Nom de la ressource à supprimer, sous la forme pages/{page_id}.

FactFactClaimSearchRequest

Requête de recherche dans des déclarations de fact-checking.

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". Peut être utilisé pour restreindre les résultats par langue, même si nous ne tenons pas compte de la région pour le moment.

review_publisher_site_filter

string

Site de l'éditeur d'avis à utiliser pour filtrer les résultats (par exemple, lemonde.fr).

max_age_days

int32

Âge maximal des résultats de recherche affichés, en jours. L'âge est déterminé par la date de la revendication ou de la date d'examen, selon la date la plus récente.

page_size

int32

Taille de la pagination. Nous renverrons autant de résultats. S'il n'est pas défini, la valeur par défaut est 10.

page_token

string

Jeton de pagination. Le cas échéant, vous pouvez fournir la valeur next_page_token d'une requête"List"antérieure pour obtenir la page suivante. Tous les autres champs doivent avoir les mêmes valeurs que dans la requête précédente.

offset

int32

Entier spécifiant le décalage actuel (c'est-à-dire l'emplacement 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. Par exemple, 0 signifie renvoyer des résultats à partir du premier résultat correspondant, et 10 signifie qu'il renvoie à partir du 11e résultat.

FactVerifiedClaimResponse

Réponse d'une recherche de fact-checking.

Champs
claims[]

Claim

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

next_page_token

string

Jeton de pagination suivant dans la réponse de recherche. Il doit ê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 d'obtention du balisage ClaimReview sur une page.

Champs
name

string

Nom de la ressource à obtenir, sous la forme pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Requête d'affichage du balisage ClaimReview.

Champs
url

string

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

organization

string

L'organisation pour laquelle nous voulons récupérer les balisages. Par exemple, "site.com". Ne peut pas être spécifié avec une URL.

page_size

int32

Taille de la pagination. Nous renverrons autant de résultats. S'il n'est pas défini, la valeur par défaut est 10. Cette méthode n'a aucun effet si une URL est demandée.

page_token

string

Jeton de pagination. Le cas échéant, vous pouvez fournir la valeur next_page_token d'une requête"List"antérieure pour obtenir la page suivante. Tous les autres champs doivent avoir les mêmes valeurs que dans la requête précédente.

offset

int32

Entier spécifiant le décalage actuel (c'est-à-dire l'emplacement 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, 0 signifie renvoyer des résultats à partir du premier résultat correspondant, et 10 signifie qu'il renvoie à partir du 11e résultat.

ListClaimReviewMarkupPagesResponse

Réponse de la fiche ClaimReview.

Champs
claim_review_markup_pages[]

ClaimReviewMarkupPage

Liste de résultats de pages contenant le balisage ClaimReview.

next_page_token

string

Jeton de pagination suivant dans la réponse de recherche. Il doit être utilisé comme page_token pour la requête suivante. Une valeur vide signifie qu'il n'y a plus de résultats.

Publisher

Informations sur l'éditeur.

Champs
name

string

Nom de cet éditeur. Par exemple, "Fact-checking" .

site

string

Nom du site au niveau de l'hôte, sans le protocole ni le préfixe "www". Par exemple, "awesomefactchecks.com". Cette valeur repose uniquement sur l'URL de vérification de la revendication.

UpdateClaimReviewMarkupPageRequest

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

Champs
claim_review_markup_page

ClaimReviewMarkupPage

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