Package google.factchecking.factchecktools.v1alpha1

索引

FactCheckToolsService

ファクト チェック ツール API

Fact Check Tools API は、Google Fact Check Tools フロントエンド（https://g.co/factchecktools）で提供される機能にプログラムでアクセスできます。

現在利用可能な API は次のとおりです。

  • Fact Checked Claim Search（Fact Check Explorer フロントエンドで提供）。

  • ページ上の ClaimReview マークアップ用の CRUD インターフェース（ファクト チェック マークアップ ツールのフロントエンドを通じて提供）。

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

ページに ClaimReview マークアップを作成する。

認証スコープ

次の OAuth スコープが必要です。

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

ページ上の ClaimReview マークアップをすべて削除する。

認証スコープ

次の OAuth スコープが必要です。

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

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

ファクト チェックされた主張を検索する。
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

ページ上の ClaimReview マークアップをすべて取得する

認証スコープ

次の OAuth スコープが必要です。

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

特定の URL または組織の ClaimReview マークアップ ページを一覧表示します。

認証スコープ

次の OAuth スコープが必要です。

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

ページ内のすべての ClaimReview マークアップの更新

これは完全な更新です。ページに既存の ClaimReview マークアップを保持するには、まず Get オペレーションを実行し、返されたマークアップを変更してから、最後に ClaimReview マークアップ全体を本文として Update を呼び出します。

認証スコープ

次の OAuth スコープが必要です。

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

請求

申し立てに関する情報。

フィールド
text

string

申し立てのテキスト。たとえば、「Crime」は過去 2 年間で倍増しています。"

claimant

string

申請を行う個人または組織。例: 「山田太郎」
claim_date

Timestamp

主張が行われた日付。

claim_review[]

ClaimReview

この主張の 1 つ以上のレビュー（つまり、ファクト チェック記事）。

主張者

申し立ての作成者に関する情報。

フィールド
name

string

申請を行う個人または組織。例: 「山田太郎」
: ClaimReview.itemReviewed.author.name に対応します。
job_title

string

ClaimReview.itemReviewed.author.jobTitle に対応します。
image_url

string

ClaimReview.itemReviewed.author.image に対応します。
same_as

string

ClaimReview.itemReviewed.author.sameAs に対応します。

申し立ての評価

申し立ての評価に関する情報。

フィールド
textual_rating

string

誠実な評価として、短い単語またはフレーズを人が読める形式にします。
: ClaimReview.reviewRating.alternateName に対応します。
rating_value

Int32Value

この申し立ての数値評価。worstRating - BestRating の範囲。
: ClaimReview.reviewRating.ratingValue に対応します。
worst_rating

Int32Value

数値による評価で、最低から最高までの範囲で可能な最も低い値。
: ClaimReview.reviewRating.worstRating に対応します。
best_rating

Int32Value

数値による評価で、最低から最高までの範囲で選択可能な最大値。
: ClaimReview.reviewRating.bestRating に対応します。
rating_explanation

string

ClaimReview.reviewRating.ratingExplanation に対応します。
image_url

string

ClaimReview.reviewRating.image に対応します。

ClaimReview

申し立ての審査に関する情報。

フィールド
publisher

Publisher

この主張のレビューを行うパブリッシャー。
url

string

この申し立てのレビューの URL。
title

string

主張の審査結果のタイトル（決定できる場合）。

review_date

Timestamp

申し立ての審査日。

textual_rating

string

テキストによる評価（例:「一部は誤り」）。

language_code

string

クチコミが書かれていた言語です。例: 「en」または「de」

申し立て審査担当者

申し立ての審査担当者に関する情報。

フィールド
name

string

ファクト チェックを公開する組織の名前。
: ClaimReview.author.name に対応します。
image_url

string

ClaimReview.author.image に対応します。

ClaimReviewMarkup

個別の ClaimReview 要素のフィールド。フィールドをグループ化するサブメッセージを除き、これらの各フィールドは https://schema.org/ClaimReview のフィールドに対応しています。フィールドごとの正確なマッピングがリストされます。

フィールド
url

string

このフィールドはオプションであり、デフォルトではページの URL になります。このフィールドでデフォルト値のオーバーライドを許可していますが、許可されている唯一のオーバーライドは、ページの URL と、オプションのアンカーリンク（「ページのジャンプ」）です。
は ClaimReview.url に対応します。
claim_reviewed

string

評価された主張の簡単な要約。
: ClaimReview.claimReviewed に対応します。
claim_date

string

主張を行った日付または主張が一般の話題になった日付。
: ClaimReview.itemReviewed.datePublished に対応します。
claim_location

string

この主張が行われた場所。
: ClaimReview.itemReviewed.name に対応します。
claim_first_appearance

string

この主張が最初に現れる作品へのリンク。
: ClaimReview.itemReviewed[@type=Claim].firstAppearance.url に対応します。
claim_appearances[]

string

この主張が表示される作品へのリンク（claim_first_appearance で指定されたものを除く）。
: ClaimReview.itemReviewed[@type=Claim].appearance.url に対応します。
claim_author

ClaimAuthor

この主張者に関する情報。

rating

ClaimRating

この請求レビューの評価に関する情報。

ClaimReviewMarkupPage

ウェブページに ClaimReview マークアップのインスタンスを 1 つ以上保持します。

フィールド
name

string

この ClaimReview マークアップ ページ リソースの名前（pages/{page_id} 形式）。更新リクエストを除き、このフィールドは出力専用です。ユーザーが設定しないでください。
page_url

string

この ClaimReview マークアップに関連付けられているページの URL。個々の ClaimReview には独自の URL フィールドがありますが、意味的には、これはページレベルのフィールドであり、このページの各 ClaimReview は、個別にオーバーライドされない限り、この値を使用します。
は ClaimReview.url に対応します。
publish_date

string

ファクト チェックが公開された日付。URL と同様に、意味的にはこれはページレベルのフィールドであり、このページの各 ClaimReview には同じ値が含まれます。
は ClaimReview.datePublished に対応します。
claim_review_author

ClaimReviewAuthor

この申し立てのレビュー投稿者に関する情報。上記と同様に、意味的にはこれらはページレベルのフィールドであり、このページの各 ClaimReview には同じ値が含まれます。

claim_review_markups[]

ClaimReviewMarkup

このページの個別の申し立てレビューのリスト。リスト内の各アイテムは 1 つの ClaimReview 要素に対応しています。
version_id

string

このマークアップのバージョン ID。更新リクエストを除き、このフィールドは出力専用です。ユーザーが設定しないでください。

CreateClaimReviewMarkupPageRequest

ページに ClaimReview マークアップを作成するリクエスト。

フィールド
claim_review_markup_page

ClaimReviewMarkupPage

このページで作成する ClaimReview マークアップ。より正規版のページ URL がある場合は、代わりにその URL が使用されます。

DeleteClaimReviewMarkupPageRequest

ページ上のすべての ClaimReview マークアップを削除するリクエスト。

フィールド
name

string

削除するリソースの名前（pages/{page_id} 形式）。

FactCheckedClaimSearchRequest

ファクト チェック済み請求に関する検索のリクエスト。

フィールド
query

string

テキストクエリ文字列。review_publisher_site_filter が指定されていない場合は必須。
language_code

string

「en-US」や「sr-Latn」などの BCP-47 言語コード。言語による結果の制限にも使用できますが、現時点では対象地域は考慮されていません。
review_publisher_site_filter

string

検索結果をフィルタするレビュー パブリッシャー サイト（例: nytimes.com）。

max_age_days

int32

返される検索結果の最大期間（日数）。年齢は、申請日または審査日のいずれか新しい方によって決まります。

page_size

int32

ページ分けサイズ。検索結果は、その数まで表示されます。設定しない場合、デフォルトで 10 になります。
page_token

string

ページ設定トークン。次のページを取得するために、前の List リクエストから返された next_page_token（存在する場合）を指定できます。他のすべてのフィールドには、前のリクエストと同じ値を指定する必要があります。
offset

int32

検索結果の現在のオフセット（つまり開始位置）を指定する整数。このフィールドは、page_token が設定されていない場合にのみ考慮されます。たとえば、0 は最初の一致する結果から開始し、10 は 11 番目の結果から戻ることを意味します。

FactCheckedClaimSearchResponse

ファクト チェック済みの主張を検索した結果。

フィールド
claims[]

Claim

請求のリストと、関連するすべての情報。
next_page_token

string

検索レスポンス内の次のページ設定トークン。次のリクエストの page_token として使用する必要があります。値が空の場合、これ以上結果がないことを意味します。

GetClaimReviewMarkupPageRequest

ページで ClaimReview マークアップを取得するリクエスト。

フィールド
name

string

取得するリソースの名前（pages/{page_id} 形式）。

ListClaimReviewMarkupPagesRequest

ClaimReview マークアップのリスティング リクエスト。

フィールド
url

string

ClaimReview マークアップを取得する URL。結果は 1 つだけです。マークアップが、指定された URL のより正規のバージョンに関連付けられている場合、代わりにその URL が返されます。組織とともに指定することはできません。
organization

string

マークアップを取得する組織。（例: &sitet.com"）。URL と一緒に指定することはできません。
page_size

int32

ページ分けサイズ。検索結果は、その数まで表示されます。設定しない場合、デフォルトで 10 になります。URL がリクエストされている場合、影響はありません。
page_token

string

ページ設定トークン。次のページを取得するために、前の List リクエストから返された next_page_token（存在する場合）を指定できます。他のすべてのフィールドには、前のリクエストと同じ値を指定する必要があります。
offset

int32

検索結果の現在のオフセット（つまり開始位置）を指定する整数。このフィールドは、page_token が設定されていない場合、リクエストが特定の URL に関するものではない場合にのみ考慮されます。たとえば、0 は最初の一致する結果から開始し、10 は 11 番目の結果から戻ることを意味します。

ListClaimReviewMarkupPagesResponse

ClaimReview マークアップの一覧表示によるレスポンス。

フィールド
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview マークアップのページのリスト。
next_page_token

string

検索レスポンス内の次のページ設定トークン。次のリクエストの page_token として使用する必要があります。値が空の場合、これ以上結果がないことを意味します。

パブリッシャー

パブリッシャーに関する情報。

フィールド
name

string

このパブリッシャーの名前。たとえば、「Awesome Fact Checks」とします。

site

string

ホストレベルのサイト名（プロトコルまたは www.quot; 接頭辞なし）。例: "Awesomefactchecks.com". このフィールドの値は、純粋に申し立て審査 URL に基づいています。

UpdateClaimReviewMarkupPageRequest

ページ上のすべての ClaimReview マークアップの更新リクエスト。

フィールド
claim_review_markup_page

ClaimReviewMarkupPage

このページの ClaimReview マークアップが更新されました。更新リクエストでは、更新するリソースのリソース名とバージョン ID の両方を指定する必要があります。指定されたバージョン ID が最新のマークアップのバージョン ID と一致しない場合（前回の読み取り以降にマークアップが変更されている場合に発生することがあります）、このリクエストは失敗します。また、更新によってページの URL が変更されることはありません。マークアップの URL を変更するには、古いマークアップを削除し、新しい URL で再作成します。