Package google.factchecking.factchecktools.v1alpha1

索引

事實查核工具服務

Fact Check Tools API

事實查核工具 API 透過 https://g.co/factchecktools 網頁,透過程式存取 Google 事實查核工具前端的功能。

目前可用的 API 如下:

  • 事實查核聲明搜尋 (透過 Fact Check Explorer 前端提供)。

  • 網頁上的 ClaimReview 標記的 CRUD 介面 (透過事實查核標記工具前端提供)。

建立版權聲明審查標記頁面

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

在網頁上建立 ClaimReview 標記。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/userinfo.email
刪除 ClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

刪除頁面中的所有 ClaimReview 標記。

授權範圍

需要下列 OAuth 範圍:

  • https://www.googleapis.com/auth/userinfo.email
事實查核搜尋

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)

列出特定網址或機構的 ClaimReview 標記網頁。

授權範圍

需要下列 OAuth 範圍:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

網頁上所有 ClaimReview 標記的更新內容

請注意,這是完整的更新。如要保留網頁上現有的 ClaimReview 標記,請先執行 Get 作業,然後修改傳回的標記,最後再以整個 ClaimReview 標記做為更新呼叫。

授權範圍

需要下列 OAuth 範圍:

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

版權聲明

版權聲明的相關資訊。

欄位
text

string

版權聲明文字。例如:「過去 2 年內一度加倍」。

claimant

string

表示版權聲明的個人或機構。例如「王大明」。

claim_date

Timestamp

版權聲明的提出日期。

claim_review[]

ClaimReview

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

版權聲明作者

版權聲明作者的相關資訊。

欄位
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 - 最佳違規評分。
對應 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」。

版權聲明審查作者

版權聲明審查作者的相關資訊。

欄位
name

string

事實查核發布機構的名稱。
對應 ClaimReview.author.name

image_url

string

對應 ClaimReview.author.image

版權聲明審查

個別 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

這項版權聲明審查的評分資訊。

版權聲明審查工具頁面

包含一或多個網頁的 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。除了更新要求外,這個欄位只能用於輸出;使用者不應設定。

建立版權聲明審查標記要求

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

欄位
claim_review_markup_page

ClaimReviewMarkupPage

為這個網頁建立的 ClaimReview 標記。如果有其他標準網頁網址,我們會改用該網址。

刪除 ClaimReviewMarkupPageRequest

要求刪除網頁中的所有 ClaimReview 標記。

欄位
name

string

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

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

分頁符記。您可以提供先前清單要求中傳回的 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 標記的網址。最多只有一項結果。如果標記與所提供網址的標準版本相關聯,我們將傳回該網址。無法與機構一併指定。

organization

string

要擷取標記的機構。例如「site.com」。無法同時指定網址和網址。

page_size

int32

分頁大小。系統會傳回該結果。如果未設定,預設值為 10。如果要求網址,就不會有任何作用。

page_token

string

分頁符記。您可以提供先前清單要求中傳回的 next_page_token (如果有的話),以便取得下一頁。所有其他欄位的值都必須與先前的要求相同。

offset

int32

一個整數,用來指定搜尋結果中的目前偏移值 (即起始結果位置)。只有在未設定 page_token 且非特定網址的要求時,系統才會考量這個欄位。舉例來說,0 代表從第一個相符結果開始傳回結果,10 代表從第 11 筆結果傳回。

ListClaimReviewMarkupPagesResponse

回應來自 ClaimReview 標記。

欄位
claim_review_markup_pages[]

ClaimReviewMarkupPage

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

next_page_token

string

搜尋回應中的下一個分頁符記。應做為下列要求的 page_token 使用。如果留空,代表沒有其他結果。

發布端

發布者的相關資訊。

欄位
name

string

這個出版商的名稱。例如「優質事實查核」。

site

string

主機層級網站名稱,不含通訊協定或「www」前置字元。例如「awesomefactchecks.com」。這個欄位的值是以版權聲明審查網址為依據。

UpdateClaimReviewMarkupPageRequest

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

欄位
claim_review_markup_page

ClaimReviewMarkupPage

已更新這個網頁的 ClaimReview 標記。更新要求必須同時指定更新的資源名稱和版本 ID。如果指定的版本 ID 與最新版標記的版本 ID (例如標記自上次讀取後有修改) 不同,此要求就會失敗。此外,更新內容不得變更網頁網址。如要變更標記網址,請刪除舊標記,並使用新網址重新建立標記。