Package google.factchecking.factchecktools.v1alpha1

索引

FactCheckToolsService

事实核查工具 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/userinfo.email
DeleteClaimReviewMarkupPage

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 标记作为正文调用 Update。

授权范围

需要以下 OAuth 作用域：

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

Claim

与版权主张相关的信息。

字段
text

string

版权主张文字。例如，“犯罪犯罪在过去 2 年内翻了一番”。

claimant

string

声明的个人或组织。例如，“John Doe”。

claim_date

Timestamp

提出申请的日期。

claim_review[]

ClaimReview

对此声明的一项或多项评价（即事实核查报道）。

版权主张作者

与版权主张作者相关的信息。

字段
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。

声明分级

与声明分级相关的信息。

字段
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”。

声明审核者

有关声明审核作者的信息。

字段
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。除了更新请求之外，此字段仅供输出，不应由用户设置。

CreateClaimReviewMarkupPageRequest

请求在网页上创建 ClaimReview 标记。

字段
claim_review_markup_page

ClaimReviewMarkupPage

要为此页面创建的 ClaimReview 标记。如果网页网址具有更规范的版本，我们会改用该版本。

DeleteClaimReviewMarkupPageRequest

请求删除网页上的所有 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

分页令牌。您可以提供上一个 List 请求返回的 next_page_token（如果有），以便获取下一页。其他所有字段的值必须与上一个请求中的值相同。
offset

int32

一个整数，用于指定搜索结果中的当前偏移量（即起始结果位置）。只有在未设置 page_token 时才会考虑此字段。例如，0 表示从第一个匹配结果返回结果，10 表示从第 11 个结果返回。

事实核查搜索响应

对经过事实核查的声明的搜索回应。

字段
claims[]

Claim

版权主张列表及其所有相关信息。

next_page_token

string

搜索响应中的下一个分页令牌。它应该用作以下请求的 page_token。空值表示不再有结果。

GetClaimReviewMarkupPageRequest

请求获取网页上的 ClaimReview 标记。

字段
name

string

要获取的资源的名称，格式为 pages/{page_id}。

ListClaimReviewMarkupPagesRequest 类中的方法

请求列出 ClaimReview 标记。

字段
url

string

要获取其 ClaimReview 标记的网址。最多只能有 1 条结果。如果标记与所提供的网址的更规范版本相关联，我们将改为返回该网址。不能与组织一起指定。
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

搜索响应中的下一个分页令牌。它应该用作以下请求的 page_token。空值表示不再有结果。

发布者

发布商的相关信息。

字段
name

string

此发布商的名称。例如，“Awesome Fact Checks”。

site

string

主机级网站名称，不带协议或“www”前缀。例如，“awesomefactchecks.com”。此字段的值完全基于声明审核网址。

UpdateClaimReviewMarkupPageRequest 类中的方法

请求更新网页上的所有 ClaimReview 标记。

字段
claim_review_markup_page

ClaimReviewMarkupPage

已更新该网页的 ClaimReview 标记。更新请求必须指定要更新的资源的资源名称和版本 ID。如果指定的版本 ID 与最新标记的版本 ID 不一致（如果相应标记自上次读取后发生了修改，就可能会发生这种情况），此请求将会失败。同时，也不能更改网页网址。如需更改标记的网址，请删除旧标记，然后使用新网址重新创建标记。