Package google.factchecking.factchecktools.v1alpha1

索引

• FactCheckToolsService (介面)
• Claim (訊息)
• ClaimAuthor (訊息)
• ClaimRating (訊息)
• ClaimReview (訊息)
• ClaimReviewAuthor (訊息)
• ClaimReviewMarkup (訊息)
• ClaimReviewMarkupPage (訊息)
• CreateClaimReviewMarkupPageRequest (訊息)
• DeleteClaimReviewMarkupPageRequest (訊息)
• FactCheckedClaimSearchRequest (訊息)
• FactCheckedClaimSearchResponse (訊息)
• GetClaimReviewMarkupPageRequest (訊息)
• ListClaimReviewMarkupPagesRequest (訊息)
• ListClaimReviewMarkupPagesResponse (訊息)
• Publisher (訊息)
• UpdateClaimReviewMarkupPageRequest (訊息)

事實查核工具服務

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 (例如標記自上次讀取後有修改) 不同，此要求就會失敗。此外，更新內容不得變更網頁網址。如要變更標記網址，請刪除舊標記，並使用新網址重新建立標記。