Package google.factchecking.factchecktools.v1alpha1

索引

FactCheckToolsService

Fact Check Tools API

Fact Check Tools API 提供程式輔助存取方式，讓您使用 Google Fact Check Tools 前端提供的功能 (網址：https://g.co/factchecktools)。

目前可用的 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)

列出特定網址或機構的 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 年內犯罪率增加一倍。」
claimant

string

提出聲明的個人或機構。例如「陳大明」。
claim_date

Timestamp

提出申請的日期。
claim_review[]

ClaimReview

這項聲明的一或多則評論 (即事實查核文章)。

ClaimAuthor

聲明作者的相關資訊。

欄位
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。

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

這項著作權聲明審查的網址。
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

這個欄位為選填欄位，預設值為網頁網址。我們提供這個欄位，讓您覆寫預設值，但只允許覆寫網頁網址，以及選用的錨點連結 (「網頁跳轉」)。
對應於 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 標記執行個體。

欄位
name

string

這個 ClaimReview 標記頁面資源的名稱，格式為 pages/{page_id}。除了更新要求外，這個欄位僅供輸出，使用者不應設定。
page_url

string

與這個 ClaimReview 標記相關聯的網頁網址。雖然每個 ClaimReview 都有自己的網址欄位，但從語意上來說，這是網頁層級的欄位，除非個別覆寫，否則這個網頁上的每個 ClaimReview 都會使用這個值。
對應於 ClaimReview.url
publish_date

string

事實查核的發布日期。與網址類似，在語意上，這是網頁層級的欄位，這個網頁上的每個 ClaimReview 都會包含相同的值。
對應於 ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

這項查證評論的作者資訊。與上述類似，這些是語意上的網頁層級欄位，這個網頁上的每個 ClaimReview 都會包含相同的值。
claim_review_markups[]

ClaimReviewMarkup

這個頁面的個別聲明審查清單。清單中的每個項目都對應一個 ClaimReview 元素。
version_id

string

這個標記的版本 ID。除了更新要求外，這個欄位僅供輸出，使用者不應設定。

CreateClaimReviewMarkupPageRequest

要求在網頁上建立 ClaimReview 標記。

欄位
claim_review_markup_page

ClaimReviewMarkupPage

為這個頁面建立的 ClaimReview 標記。如果我們找到更標準的網頁網址版本，就會改用該版本。

DeleteClaimReviewMarkupPageRequest

要求刪除頁面上的所有 ClaimReview 標記。

欄位
name

string

要刪除的資源名稱，格式為 pages/{page_id}。

FactCheckedClaimImageSearchRequest

要求透過圖片搜尋經過事實查核的主張。

欄位
image_uri

string

必要欄位。來源圖片的 URI。這必須是可公開存取的圖片 HTTP/HTTPS 網址。

從 HTTP/HTTPS 網址擷取圖片時，Google 無法保證要求一定會完成。如果指定主機拒絕要求 (例如因要求節流或防止 DOS 攻擊)，或 Google 為防止濫用而節流對網站的要求，您的要求可能會失敗。您不應依賴外部代管的圖片來製作應用程式。
language_code

string

(選用步驟) BCP-47 語言代碼，例如「en-US」或「sr-Latn」。可用於依語言限制結果，但我們目前不會考量地區。
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

Search 回應中的下一個分頁符記。應用來當做下一個要求的 page_token。如果值為空白，表示沒有其他結果。

結果

著作權聲明和相關資訊。

欄位
claim

Claim

符合查詢的著作權聲明。

FactCheckedClaimSearchRequest

要求搜尋經過事實查核的聲明。

欄位
query

string

文字查詢字串。除非指定 review_publisher_site_filter，否則為必填欄位。
language_code

string

BCP-47 語言代碼，例如「en-US」或「sr-Latn」。可用於依語言限制結果，但我們目前不會考量地區。
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

Search 回應中的下一個分頁符記。應用來當做下一個要求的 page_token。如果值為空白，表示沒有其他結果。

GetClaimReviewMarkupPageRequest

要求取得網頁上的 ClaimReview 標記。

欄位
name

string

要取得的資源名稱，格式為 pages/{page_id}。

ListClaimReviewMarkupPagesRequest

要求標記 ClaimReview。

欄位
url

string

要從中取得 ClaimReview 標記的網址。最多只會有一項結果。如果標記與所提供網址的標準版本相關聯，我們會改為傳回該網址。無法與機構一併指定。
organization

string

我們要擷取標記的機構。例如「site.com」。無法與網址一併指定。
page_size

int32

分頁大小。我們最多會傳回該數量的結果。如未設定，預設值為 10。如果要求的是網址，則不會產生任何作用。
page_token

string

分頁符記。如要取得下一頁，您可以提供先前的 List 要求傳回的 next_page_token (如有)。其他欄位的值必須與先前的要求相同。
offset

int32

在搜尋結果中指定目前偏移量的整數 (也就是起始結果位置)。只有在未設定 page_token，且要求並非針對特定網址時，才會考慮使用此欄位。例如，0 代表從第一筆相符的結果開始傳回結果，10 代表從第 11 筆結果開始傳回。

ListClaimReviewMarkupPagesResponse

來自房源標記 ClaimReview 的回應。

欄位
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview 標記的網頁結果清單。
next_page_token

string

Search 回應中的下一個分頁符記。應用來當做下一個要求的 page_token。如果值為空白，表示沒有其他結果。

發布商

發布者相關資訊。

欄位
name

string

這個發布者的名稱。例如「Awesome Fact Checks」。
site

string

主機層級的網站名稱，不含通訊協定或「www」前置字串。例如「awesomefactchecks.com」。這個欄位的值完全是根據聲明審查網址而定。

UpdateClaimReviewMarkupPageRequest

要求更新網頁上的所有 ClaimReview 標記。

欄位
claim_review_markup_page

ClaimReviewMarkupPage

這個頁面的更新版 ClaimReview 標記。更新要求必須指定要更新的資源名稱和資源版本 ID。如果指定的版本 ID 與最新標記的版本 ID 不符 (標記可能在上次讀取後經過修改)，這項要求就會失敗。更新也不得變更網頁網址。如要變更標記的網址，請刪除舊標記，然後使用新網址重新建立標記。