Package google.factchecking.factchecktools.v1alpha1

Index

FactCheckToolsService

Fact Check Tools API

Die Fact Check Tools API bietet programmatischen Zugriff auf die Funktionen, die über das Frontend der Google Fact Check Tools unter https://g.co/factchecktools verfügbar sind.

Derzeit sind folgende APIs verfügbar:

  • Suche nach überprüften Behauptungen (über das Frontend des Faktencheck-Tools).
  • Suche nach Behauptungen, deren Fakten geprüft wurden, anhand von Bildern (über das Frontend des Faktencheck-Tools).

  • CRUD-Schnittstelle für ClaimReview-Markup auf einer Seite (über das Frontend des Faktencheck-Markup-Tools).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Erstellen Sie ClaimReview-Markup auf einer Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Löschen Sie das gesamte ClaimReview-Markup auf einer Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Faktencheck-Behauptungen anhand eines Bildes als Abfrage durchsuchen
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Nach Behauptungen suchen, die einem Faktencheck unterzogen wurden
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Alle ClaimReview-Markierungen auf einer Seite abrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

ClaimReview-Markup-Seiten für eine bestimmte URL oder für eine Organisation auflisten

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Aktualisierung für alle ClaimReview-Markups auf einer Seite

Hinweis: Dies ist eine vollständige Aktualisierung. Wenn Sie das vorhandene ClaimReview-Markup auf einer Seite beibehalten möchten, führen Sie zuerst einen Get-Vorgang aus, ändern Sie dann das zurückgegebene Markup und rufen Sie schließlich Update mit dem gesamten ClaimReview-Markup als Textkörper auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Anspruch

Informationen zum Anspruch.

Felder
text

string

Der Text der Behauptung. Beispiel: „Die Kriminalität hat sich in den letzten zwei Jahren verdoppelt.“
claimant

string

Eine Person oder Organisation, die den Anspruch erhebt. Zum Beispiel „Max Mustermann“.
claim_date

Timestamp

Das Datum, an dem der Anspruch erhoben wurde.
claim_review[]

ClaimReview

Mindestens eine Rezension dieser Behauptung (d. h. ein Artikel zur Faktenprüfung).

ClaimAuthor

Informationen zum Autor der Behauptung.

Felder
name

string

Eine Person oder Organisation, die den Anspruch erhebt. Zum Beispiel „Max Mustermann“.
entspricht ClaimReview.itemReviewed.author.name.
job_title

string

Entspricht ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Entspricht ClaimReview.itemReviewed.author.image.
same_as

string

Entspricht ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informationen zur Bewertung des Anspruchs.

Felder
textual_rating

string

Die Einstufung des Wahrheitsgehalts als für den Menschen lesbarer Text in Form eines Wortes oder einer kurzen Phrase.
entspricht ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Eine numerische Bewertung dieser Behauptung im Bereich zwischen worstRating und bestRating (jeweils einschließlich).
entspricht ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Bei Bewertungen der niedrigstmögliche Wert auf der Skala vom schlechtesten bis zum besten Wert.
entspricht ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Bei Bewertungen der höchstmögliche Wert auf der Skala vom schlechtesten bis zum besten Wert.
entspricht ClaimReview.reviewRating.bestRating.
rating_explanation

string

Entspricht ClaimReview.reviewRating.ratingExplanation.
image_url

string

Entspricht ClaimReview.reviewRating.image.

ClaimReview

Informationen zu einer Anspruchsprüfung.

Felder
publisher

Publisher

Der Publisher dieser Überprüfung der Behauptung.
url

string

Die URL dieser Anspruchsprüfung.
title

string

Der Titel dieser Anspruchsprüfung, sofern er ermittelt werden kann.
review_date

Timestamp

Das Datum, an dem der Anspruch überprüft wurde.
textual_rating

string

Textbezogene Bewertung Beispiel: „Mostly false“ (Größtenteils falsch).
language_code

string

Die Sprache, in der diese Rezension verfasst wurde. Beispiel: „en“ oder „de“.

ClaimReviewAuthor

Informationen zum Autor der Anspruchsprüfung.

Felder
name

string

Der Name der Organisation, die den Faktencheck veröffentlicht.
entspricht ClaimReview.author.name.
image_url

string

Entspricht ClaimReview.author.image.

ClaimReviewMarkup

Felder für ein einzelnes ClaimReview-Element. Mit Ausnahme von untergeordneten Nachrichten, in denen Felder gruppiert werden, entspricht jedes dieser Felder den Feldern in https://schema.org/ClaimReview. Die genaue Zuordnung für jedes Feld ist unten aufgeführt.

Felder
url

string

Dieses Feld ist optional und wird standardmäßig auf die Seiten-URL gesetzt. Wir stellen dieses Feld zur Verfügung, damit Sie den Standardwert überschreiben können. Die einzige zulässige Überschreibung ist jedoch die Seiten-URL plus ein optionaler Ankerlink („Seitenanker“).
entspricht ClaimReview.url
claim_reviewed

string

Eine kurze Zusammenfassung der überprüften Behauptung.
entspricht ClaimReview.claimReviewed.
claim_date

string

Das Datum, an dem die Behauptung aufgestellt wurde oder an die Öffentlichkeit gelangt ist.
entspricht ClaimReview.itemReviewed.datePublished.
claim_location

string

Der Ort, an dem dieser Anspruch erhoben wurde.
entspricht ClaimReview.itemReviewed.name.
claim_first_appearance

string

Ein Link zu einem Werk, in dem diese Behauptung zum ersten Mal aufgestellt wurde.
entspricht ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Eine Liste von Links zu Werken, in denen diese Behauptung aufgestellt wird, abgesehen von dem in claim_first_appearance angegebenen Werk.
entspricht ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Informationen zum Autor dieses Anspruchs.
rating

ClaimRating

Informationen zur Bewertung dieser Überprüfung von Behauptungen.

ClaimReviewMarkupPage

Enthält eine oder mehrere Instanzen von ClaimReview-Markup für eine Webseite.

Felder
name

string

Der Name dieser ClaimReview-Markup-Seitenressource im Format pages/{page_id}. Mit Ausnahme von Aktualisierungsanfragen ist dieses Feld nur für die Ausgabe bestimmt und sollte nicht vom Nutzer festgelegt werden.
page_url

string

Die URL der Seite, die mit diesem ClaimReview-Markup verknüpft ist. Jedes einzelne ClaimReview hat zwar ein eigenes URL-Feld, semantisch ist dies jedoch ein Feld auf Seitenebene. Jeder ClaimReview auf dieser Seite verwendet diesen Wert, sofern er nicht individuell überschrieben wird.
entspricht ClaimReview.url
publish_date

string

Das Datum, an dem der Faktencheck veröffentlicht wurde. Ähnlich wie bei der URL ist dies semantisch ein Feld auf Seitenebene. Jedes ClaimReview auf dieser Seite enthält denselben Wert.
entspricht ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Informationen zum Autor dieser Anspruchsprüfung. Wie oben beschrieben sind diese Felder semantisch Felder auf Seitenebene. Jeder ClaimReview auf dieser Seite enthält dieselben Werte.
claim_review_markups[]

ClaimReviewMarkup

Eine Liste der einzelnen Faktenchecks für diese Seite. Jedes Element in der Liste entspricht einem ClaimReview-Element.
version_id

string

Die Versions-ID für dieses Markup. Mit Ausnahme von Aktualisierungsanfragen ist dieses Feld nur für die Ausgabe bestimmt und sollte nicht vom Nutzer festgelegt werden.

CreateClaimReviewMarkupPageRequest

Anfrage zum Erstellen von ClaimReview-Markup auf einer Seite.

Felder
claim_review_markup_page

ClaimReviewMarkupPage

Die ClaimReview-Markierung, die für diese Seite erstellt werden soll. Wenn eine kanonischere Version der Seiten-URL angegeben ist, verwenden wir diese.

DeleteClaimReviewMarkupPageRequest

Anfrage zum Löschen aller ClaimReview-Markups auf einer Seite.

Felder
name

string

Der Name der zu löschenden Ressource im Format pages/{page_id}.

FactCheckedClaimImageSearchRequest

Anfrage zum Suchen nach faktengeprüften Behauptungen anhand von Bildern

Felder
image_uri

string

Erforderlich. Der URI des Quell-Images. Dies muss eine öffentlich zugängliche HTTP-/HTTPS-Bild-URL sein.

Beim Abrufen von Bildern von HTTP- oder HTTPS-URLs kann Google nicht garantieren, dass die Anfrage abgeschlossen wird. Ihre Anfrage kann fehlschlagen, wenn der angegebene Host die Anfrage ablehnt (z.B. aufgrund von Anfragendrosselung oder zur DoS-Prävention) oder wenn Google Anfragen an die Website drosselt, um Missbrauch vorzubeugen. Sie sollten sich bei Produktionsanwendungen nicht auf extern gehostete Bilder verlassen.
language_code

string

Optional. Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Kann verwendet werden, um Ergebnisse nach Sprache einzuschränken. Die Region wird derzeit jedoch nicht berücksichtigt.
page_size

int32

Optional. Die Paginierungsgröße. Wir geben maximal so viele Ergebnisse zurück. Wenn kein Wert festgelegt ist, wird der Standardwert 10 verwendet.
page_token

string

Optional. Das Paginierungstoken. Sie können das next_page_token aus einer vorherigen Listenanfrage angeben, um die nächste Seite abzurufen. Alle anderen Felder müssen dieselben Werte wie in der vorherigen Anfrage haben.
offset

int32

Optional. Eine Ganzzahl, die den aktuellen Offset (d. h. die Startposition des Ergebnisses) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn page_token nicht festgelegt wurde. Wenn Sie beispielsweise 0 angeben, werden Ergebnisse ab dem ersten übereinstimmenden Ergebnis zurückgegeben. Bei 10 werden Ergebnisse ab dem 11. Ergebnis zurückgegeben.

FactCheckedClaimImageSearchResponse

Antwort auf die Suche nach faktengeprüften Behauptungen anhand von Bildern.

Felder
results[]

Result

Die Liste der Ansprüche und alle zugehörigen Informationen.
next_page_token

string

Das nächste Paginierungstoken in der Suchantwort. Es sollte als page_token für die folgende Anfrage verwendet werden. Ein leerer Wert bedeutet, dass keine weiteren Ergebnisse vorhanden sind.

Ergebnis

Ein Anspruch und die zugehörigen Informationen.

Felder
claim

Claim

Ein Anspruch, der mit der Anfrage übereinstimmt.

FactCheckedClaimSearchRequest

Anfrage zum Durchsuchen von Behauptungen, die einem Faktencheck unterzogen wurden

Felder
query

string

Textbasierter Abfragestring. Erforderlich, sofern review_publisher_site_filter nicht angegeben ist.
language_code

string

Der BCP-47-Sprachcode, z. B. "en-US" oder "sr-Latn" Kann verwendet werden, um Ergebnisse nach Sprache einzuschränken. Die Region wird derzeit jedoch nicht berücksichtigt.
review_publisher_site_filter

string

Die Website des Rezensions-Publishers, nach der die Ergebnisse gefiltert werden sollen, z.B. nytimes.com.
max_age_days

int32

Das maximale Alter der zurückgegebenen Suchergebnisse in Tagen. Das Alter wird entweder anhand des Datums der Anspruchserhebung oder des Datums der Überprüfung bestimmt, je nachdem, welches neuer ist.
page_size

int32

Die Paginierungsgröße. Wir geben maximal so viele Ergebnisse zurück. Wenn kein Wert festgelegt ist, wird der Standardwert 10 verwendet.
page_token

string

Das Paginierungstoken. Sie können das next_page_token aus einer vorherigen Listenanfrage angeben, um die nächste Seite abzurufen. Alle anderen Felder müssen dieselben Werte wie in der vorherigen Anfrage haben.
offset

int32

Eine Ganzzahl, die den aktuellen Offset (d. h. die Startposition des Ergebnisses) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn page_token nicht festgelegt wurde. Wenn Sie beispielsweise 0 angeben, werden Ergebnisse ab dem ersten übereinstimmenden Ergebnis zurückgegeben. Bei 10 werden Ergebnisse ab dem 11. Ergebnis zurückgegeben.

FactCheckedClaimSearchResponse

Antwort auf die Suche nach faktengeprüften Behauptungen.

Felder
claims[]

Claim

Die Liste der Ansprüche und alle zugehörigen Informationen.
next_page_token

string

Das nächste Paginierungstoken in der Suchantwort. Es sollte als page_token für die folgende Anfrage verwendet werden. Ein leerer Wert bedeutet, dass keine weiteren Ergebnisse vorhanden sind.

GetClaimReviewMarkupPageRequest

Anfrage zum Abrufen des ClaimReview-Markups auf einer Seite

Felder
name

string

Der Name der abzurufenden Ressource im Format pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Anfrage zum Auflisten der ClaimReview-Markierung.

Felder
url

string

Die URL, von der das ClaimReview-Markup abgerufen werden soll. Es gibt höchstens ein Ergebnis. Wenn Markup mit einer kanonischeren Version der angegebenen URL verknüpft ist, geben wir stattdessen diese URL zurück. Kann nicht zusammen mit einer Organisation angegeben werden.
organization

string

Die Organisation, für die wir Markierungen abrufen möchten. Beispiel: „site.com“. Kann nicht zusammen mit einer URL angegeben werden.
page_size

int32

Die Paginierungsgröße. Wir geben maximal so viele Ergebnisse zurück. Wenn kein Wert festgelegt ist, wird der Standardwert 10 verwendet. Hat keine Auswirkungen, wenn eine URL angefordert wird.
page_token

string

Das Paginierungstoken. Sie können das next_page_token aus einer vorherigen Listenanfrage angeben, um die nächste Seite abzurufen. Alle anderen Felder müssen dieselben Werte wie in der vorherigen Anfrage haben.
offset

int32

Eine Ganzzahl, die den aktuellen Offset (d. h. die Startposition des Ergebnisses) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn page_token nicht festgelegt ist und die Anfrage sich nicht auf eine bestimmte URL bezieht. Wenn Sie beispielsweise 0 angeben, werden Ergebnisse ab dem ersten übereinstimmenden Ergebnis zurückgegeben. Bei 10 werden Ergebnisse ab dem 11. Ergebnis zurückgegeben.

ListClaimReviewMarkupPagesResponse

Antwort vom Markup für die Auflistung ClaimReview.

Felder
claim_review_markup_pages[]

ClaimReviewMarkupPage

Die Ergebnisliste der Seiten mit ClaimReview-Markup.
next_page_token

string

Das nächste Paginierungstoken in der Suchantwort. Es sollte als page_token für die folgende Anfrage verwendet werden. Ein leerer Wert bedeutet, dass keine weiteren Ergebnisse vorhanden sind.

Publisher

Informationen zum Publisher.

Felder
name

string

Der Name dieses Publishers. Beispiel: „Awesome Fact Checks“
site

string

Websitename auf Hostebene ohne Protokoll oder „www“-Präfix. Beispiel: „awesomefactchecks.com“. Der Wert dieses Felds basiert ausschließlich auf der URL für die Überprüfung von Ansprüchen.

UpdateClaimReviewMarkupPageRequest

Anfrage zum Aktualisieren aller ClaimReview-Markups auf einer Seite.

Felder
claim_review_markup_page

ClaimReviewMarkupPage

Das aktualisierte ClaimReview-Markup für diese Seite. In Aktualisierungsanfragen müssen sowohl der Ressourcenname als auch die Versions-ID der zu aktualisierenden Ressource angegeben werden. Wenn die angegebene Versions-ID nicht mit der Versions-ID des neuesten Markups übereinstimmt (was passieren kann, wenn das Markup seit dem letzten Lesen geändert wurde), schlägt diese Anfrage fehl. Durch Aktualisierungen darf sich die Seiten-URL nicht ändern. Wenn Sie die URL des Markups ändern möchten, löschen Sie das alte Markup und erstellen Sie es mit der neuen URL neu.