Package google.factchecking.factchecktools.v1alpha1

Index

Faktencheck-Tools

Faktencheck-API

Die Fact Check Tools API bietet programmatischen Zugriff auf die Funktionen, die über das Google Fact Check Tools-Front-End unter https://g.co/factchecktools zur Verfügung gestellt werden.

Folgende APIs sind derzeit verfügbar:

  • Suche nach Faktenchecks über das Front-End von Fact Check Explorer

  • CRUD-Oberfläche für ClaimReview-Markup auf einer Seite (wird über das Fact Check Markup Tool-Front-End bereitgestellt).

MarkupClaimCreateCreateReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Erstelle ClaimReview-Markup auf einer Seite.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/userinfo.email
MarkupClaimMarkupMarkupPage löschen

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

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Suche Behauptungen mit Faktenchecks.
Markup der Markupseite

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Das gesamte ClaimReview-Markup auf einer Seite abrufen

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Listen Sie die ClaimReview-Markup-Seiten für eine bestimmte URL oder für eine Organisation auf.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

  • https://www.googleapis.com/auth/userinfo.email
MarkupClaim-Seite aktualisieren

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Aktualisierung für das gesamte ClaimReview-Markup auf einer Seite

Beachte bitte, dass dies ein vollständiges Update ist. Wenn du das vorhandene ClaimReview-Markup auf einer Seite beibehalten möchtest, musst du zuerst einen Get-Vorgang ausführen, dann das zurückgegebene Markup ändern und schließlich „Update“ mit dem gesamten ClaimReview-Markup als Text aufrufen.

Autorisierungsbereiche

Erfordert den folgenden OAuth-Bereich:

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

Claim

Informationen zum Anspruch.

Felder
text

string

Der Anspruchstext. Beispiel: „Kriminalität hat sich in den letzten zwei Jahren verdoppelt.“

claimant

string

Eine Person oder Organisation, die die Behauptung aufgestellt hat. Beispiel: "Max Mustermann"

claim_date

Timestamp

Das Datum, an dem der Anspruch erhoben wurde.

claim_review[]

ClaimReview

Eine oder mehrere Rezensionen zu dieser Behauptung (ein Artikel mit Faktenchecks)

Anspruchsautor

Informationen zum Anspruchsteller.

Felder
name

string

Eine Person oder Organisation, die die Behauptung aufgestellt hat. 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.

Anspruchsbewertung

Informationen zur Anspruchsbewertung.

Felder
textual_rating

string

Die Einstufung des Wahrheitsgehalts als für Menschen lesbares kurzes Wort oder kurze Wortgruppe.
Entspricht ClaimReview.reviewRating.alternateName.

rating_value

Int32Value

Eine numerische Bewertung dieser Behauptung im Bereich „worstRating“ (einschließlich „bestRating“).
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 Faktenprüfung.

Felder
publisher

Publisher

Der Publisher dieser Anspruchsprüfung.

url

string

Die URL dieser Anspruchsprüfung.

title

string

Der Titel dieser Anspruchsprüfung, sofern diese festgestellt werden kann.

review_date

Timestamp

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

textual_rating

string

Textbewertung. Beispiel: "Überwiegend falsch".

language_code

string

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

Anspruchsautor

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.

Markup für Anspruchsüberprüfung

Felder für ein einzelnes ClaimReview-Element. Mit Ausnahme der Teilnachrichten, die Felder zusammenfassen, entsprechen alle diese Felder den Feldern in https://schema.org/ClaimReview. Für jedes Feld wird eine genaue Zuordnung aufgelistet.

Felder
url

string

Dieses Feld ist optional und standardmäßig auf die Seiten-URL ausgerichtet. Über dieses Feld können Sie den Standardwert überschreiben. Lediglich die Seiten-URL und ein optionaler Ankerlink ("pagejump") sind zulässig.
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 dieser Anspruch zuerst erscheint.
Entspricht ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Eine Liste mit Links zu Werken, in denen dieser Anspruch angezeigt wird, mit Ausnahme der in claim_first_appearance angegebenen.
Entspricht ClaimReview.itemReviewed[@type=Claim].appearance.url.

claim_author

ClaimAuthor

Informationen zum Autor dieser Behauptung.

rating

ClaimRating

Informationen zur Bewertung dieser Anspruchsprüfung.

MarkupReview "ClaimReview"

Enthält eine oder mehrere Instanzen des ClaimReview-Markups für eine Webseite.

Felder
name

string

Der Name dieser ClaimReview-Markup-Seitenressource im Format pages/{page_id}. Außer bei Aktualisierungsanfragen ist dieses Feld rein und nur für den Nutzer vorgesehen.

page_url

string

Die URL der Seite, die mit diesem ClaimReview-Markup verknüpft ist. Jede einzelne ClaimReview hat ein eigenes URL-Feld. Semantisch ist dies jedoch ein Feld auf Seitenebene. Jeder ClaimReview auf dieser Seite verwendet diesen Wert, es sei denn, er wird individuell überschrieben.
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. Jede ClaimReview auf dieser Seite enthält denselben Wert.
Entspricht ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Informationen zum Autor dieser Anspruchsprüfung. Semantisch sind dies semantische Felder auf Seitenebene. Jedes ClaimReview auf dieser Seite enthält dieselben Werte.

claim_review_markups[]

ClaimReviewMarkup

Eine Liste einzelner Prüfungen von Ansprüchen auf diese Seite. Jeder Listeneintrag entspricht einem ClaimReview-Element.

version_id

string

Die Versions-ID für dieses Markup. Außer bei Aktualisierungsanfragen ist dieses Feld rein und nur für den Nutzer vorgesehen.

RequestClaimMarkupMarkupPageRequest erstellen

Anfrage zum Erstellen von ClaimReview-Markup auf einer Seite.

Felder
claim_review_markup_page

ClaimReviewMarkupPage

Das ClaimReview-Markup, das für diese Seite erstellt werden soll. Wenn es eine kanonische Version der Seiten-URL gibt, verwenden wir stattdessen diese.

MarkupClaimMarkupMarkupPageRequest löschen

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

Felder
name

string

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

Faktenchecker-Suchanfrage

Anfrage zur Überprüfung von Faktenchecks.

Felder
query

string

Text-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 die Ergebnisse nach Sprache einzuschränken, auch wenn die Region derzeit nicht berücksichtigt wird.

review_publisher_site_filter

string

Die Publisher-Website, auf der die Ergebnisse gefiltert werden sollen, z. B. nytimes.com

max_age_days

int32

Das Höchstalter der zurückgegebenen Suchergebnisse in Tagen. Das Alter wird entweder anhand des Anspruchsdatums oder dem Datum der Überprüfung ermittelt, je nachdem, welches Datum jünger ist.

page_size

int32

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

page_token

string

Das Paginierungstoken. Sie können gegebenenfalls die next_page_token aus einer vorherigen Listenanfrage angeben, um zur nächsten Seite zu gelangen. Alle anderen Felder müssen dieselben Werte wie in der vorherigen Anfrage haben.

offset

int32

Eine Ganzzahl, die den aktuellen Offset (d. h. den Startort des Ergebnisses) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn page_token nicht festgelegt ist. 0 bedeutet beispielsweise, dass Ergebnisse ab dem ersten übereinstimmenden Ergebnis zurückgegeben werden, und 10, dass vom 11. Ergebnis zurückgegeben werden soll.

FactCheckedClaimSearchResponse

Antwort aus der Suche nach Behauptungen mit Faktenchecks.

Felder
claims[]

Claim

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

next_page_token

string

Das nächste Paginierungstoken in der Suchantwort. Sie sollte als page_token für die folgende Anfrage verwendet werden. Bei einem leeren Wert sind keine Ergebnisse mehr verfügbar.

GetClaimReviewMarkupPageRequest

Anforderung zum Abrufen des ClaimReview-Markups auf einer Seite.

Felder
name

string

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

ListClaimReviewMarkupPagesRequest

Anfrage zur Auflistung von ClaimReview-Markup.

Felder
url

string

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

organization

string

Die Organisation, für die wir Markups abrufen möchten. Beispiel: "site.com" Kann nicht mit einer URL angegeben werden.

page_size

int32

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

page_token

string

Das Paginierungstoken. Sie können gegebenenfalls die next_page_token aus einer vorherigen Listenanfrage angeben, um zur nächsten Seite zu gelangen. Alle anderen Felder müssen dieselben Werte wie in der vorherigen Anfrage haben.

offset

int32

Eine Ganzzahl, die den aktuellen Offset (d. h. den Startort des Ergebnisses) in den Suchergebnissen angibt. Dieses Feld wird nur berücksichtigt, wenn page_token nicht festgelegt ist und die Anfrage nicht für eine bestimmte URL gilt. 0 bedeutet beispielsweise, dass Ergebnisse ab dem ersten übereinstimmenden Ergebnis zurückgegeben werden, und 10, dass vom 11. Ergebnis zurückgegeben werden soll.

ListClaimReviewMarkupPagesResponse

Antwort vom ClaimReview-Markup.

Felder
claim_review_markup_pages[]

ClaimReviewMarkupPage

Die Ergebnisliste der Seiten mit ClaimReview-Markup.

next_page_token

string

Das nächste Paginierungstoken in der Suchantwort. Sie sollte als page_token für die folgende Anfrage verwendet werden. Bei einem leeren Wert sind keine Ergebnisse mehr verfügbar.

Publisher

Informationen zum Publisher

Felder
name

string

Der Name des Publishers Beispiel: „Awesome Fact Checks“.

site

string

Websitename auf Hostebene ohne Protokoll oder Präfix „www"“ Beispiel: "awesomefactchecks.com" Der Wert dieses Felds basiert ausschließlich auf der URL zur Anspruchsprüfung.

UpdateClaimMarkupMarkupPageRequest

Anfrage zum Aktualisieren des gesamten ClaimReview-Markups auf einer Seite.

Felder
claim_review_markup_page

ClaimReviewMarkupPage

Das aktualisierte ClaimReview-Markup für diese Seite. Bei 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 letzten Markups übereinstimmt (was beispielsweise passieren kann, wenn das Markup seit dem letzten Lesen geändert wurde), schlägt die Anfrage fehl. Bei einer Aktualisierung darf auch die Seiten-URL nicht geändert werden. Wenn Sie die URL des Markups ändern möchten, löschen Sie das alte Markup und erstellen Sie es mit der neuen URL neu.