Package google.factchecking.factchecktools.v1alpha1

インデックス

FactCheckToolsService

Fact Check Tools API

ファクト チェック ツール API は、https://g.co/factchecktools の Google ファクト チェック ツール フロントエンドで提供される機能へのプログラマティック アクセスを提供します。

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

  • ファクト チェック済みの主張の検索（ファクト チェック エクスプローラのフロントエンドを通じて提供）。
  • 画像によるファクト チェック済みの主張の検索（ファクト チェック エクスプローラのフロントエンドを通じて提供）。

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

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

認可スコープ

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

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

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

認可スコープ

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

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

画像をクエリとして使用して、ファクト チェック済みの主張を検索します。
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

ファクト チェック済みの主張を検索する。
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

認可スコープ

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

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

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

認可スコープ

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

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

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

認可スコープ

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

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

申し立て

申し立てに関する情報。

フィールド
text

string

申し立てのテキスト。たとえば、「過去 2 年間で犯罪が 2 倍になった」などです。
claimant

string

申し立てを行う個人または組織。たとえば、「John Doe」です。
claim_date

Timestamp

申し立てが行われた日付。
claim_review[]

ClaimReview

この主張に関する 1 件以上のレビュー（ファクト チェック記事）。

ClaimAuthor

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

フィールド
name

string

申し立てを行う個人または組織。たとえば、「John Doe」です。
は 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 に対応しています。

ClaimRating

請求の評価に関する情報。

フィールド
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」など）。

ClaimReviewAuthor

主張のレビューの作成者に関する情報。

フィールド
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

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

フィールド
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 の正規版が提供されている場合は、そちらを使用します。

DeleteClaimReviewMarkupPageRequest

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

フィールド
name

string

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

FactCheckedClaimImageSearchRequest

画像でファクト チェック済みの主張を検索するリクエスト。

フィールド
image_uri

string

必須。ソース画像の URI。これは、一般公開されている画像の HTTP/HTTPS URL である必要があります。

HTTP/HTTPS URL から画像を取得する場合、リクエストが完了するとは限りません。リクエストの調整や DOS 防止などのため、指定したホストがリクエストを拒否することがあります。また、不正利用を防止するため、Google がサイトに対するリクエストを調整することもあります。このような状況ではリクエストが失敗します。したがって、本番環境のアプリケーションが外部ホストの画像に頼ることはよくありません。
language_code

string

省略可。「en-US」や「sr-Latn」などの BCP-47 言語コード。言語で結果を制限するために使用できますが、現時点では地域は考慮されません。
page_size

int32

省略可。ページ設定のサイズ。その数までの結果が返されます。設定しない場合、デフォルトは 10 です。
page_token

string

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

int32

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

FactCheckedClaimImageSearchResponse

画像でファクトチェック済みの主張を検索した結果のレスポンス。

フィールド
results[]

Result

申し立てのリストと、それに関連するすべての情報。
next_page_token

string

検索レスポンスでの次のページ設定トークン。後続のリクエストでは、page_token として使用されます。値が空の場合は、結果はありません。

結果

申し立てとその関連情報。

フィールド
claim

Claim

クエリに一致した申し立て。

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

マークアップを取得する組織。たとえば、「site.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」接頭辞は含めません。たとえば、「awesomefactchecks.com」などです。このフィールドの値は、申し立て審査 URL のみに基づいています。

UpdateClaimReviewMarkupPageRequest

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

フィールド
claim_review_markup_page

ClaimReviewMarkupPage

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