此页面由 Cloud Translation API 翻译。

Package google.factchecking.factchecktools.v1alpha1

索引

FactCheckToolsService（接口）
Claim（消息）
ClaimAuthor（消息）
ClaimRating（消息）
ClaimReview（消息）
ClaimReviewAuthor（消息）
ClaimReviewMarkup（消息）
ClaimReviewMarkupPage（消息）
CreateClaimReviewMarkupPageRequest（消息）
DeleteClaimReviewMarkupPageRequest（消息）
FactCheckedClaimSearchRequest（消息）
FactCheckedClaimSearchResponse（消息）
GetClaimReviewMarkupPageRequest（消息）
ListClaimReviewMarkupPagesRequest（消息）
ListClaimReviewMarkupPagesResponse（消息）
Publisher（消息）
UpdateClaimReviewMarkupPageRequest（消息）

FactCheckToolsService

事实核查工具 API

借助 Fact Check Tools API，您可以以编程方式访问通过 Google Fact Check Tools 前端提供的功能，网址为 https://g.co/factchecktools。

目前可用的 API 包括：

事实核查声明搜索（通过事实核查浏览器前端提供）。
网页上 ClaimReview 标记的 CRUD 接口（通过事实核查标记工具前端提供）。

CreateClaimReviewMarkupPage

CreateClaimReviewMarkupPage
`rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)` 在网页上创建 `ClaimReview` 标记。授权范围需要以下 OAuth 作用域： `https://www.googleapis.com/auth/userinfo.email`

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

在网页上创建 ClaimReview 标记。

授权范围

需要以下 OAuth 作用域：

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

DeleteClaimReviewMarkupPage

DeleteClaimReviewMarkupPage
`rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)` 删除网页上的所有 `ClaimReview` 标记。授权范围需要以下 OAuth 作用域： `https://www.googleapis.com/auth/userinfo.email`

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

删除网页上的所有 ClaimReview 标记。

授权范围

需要以下 OAuth 作用域：

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

事实核查搜索

事实核查搜索
`rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)` 搜索经过事实核查的声明。

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

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

GetClaimReviewMarkupPage

GetClaimReviewMarkupPage
`rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)` 获取网页上的所有 `ClaimReview` 标记。授权范围需要以下 OAuth 作用域： `https://www.googleapis.com/auth/userinfo.email`

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

获取网页上的所有 ClaimReview 标记。

授权范围

需要以下 OAuth 作用域：

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

ListClaimReviewMarkupPages

ListClaimReviewMarkupPages
`rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)` 列出特定网址或组织的 `ClaimReview` 标记页面。授权范围需要以下 OAuth 作用域： `https://www.googleapis.com/auth/userinfo.email`

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

列出特定网址或组织的 ClaimReview 标记页面。

授权范围

需要以下 OAuth 作用域：

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

UpdateClaimReviewMarkupPage

UpdateClaimReviewMarkupPage
`rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)` 更新网页上的所有 `ClaimReview` 标记请注意，这是完整的更新。要保留网页上的现有 `ClaimReview` 标记，请先执行 Get 操作，然后修改返回的标记，最后以整个 `ClaimReview` 标记作为正文调用 Update。授权范围需要以下 OAuth 作用域： `https://www.googleapis.com/auth/userinfo.email`

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`。

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` 标记。如果网页网址具有更规范的版本，我们会改用该版本。

claim_review_markup_page

ClaimReviewMarkupPage

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

DeleteClaimReviewMarkupPageRequest

请求删除网页上的所有 ClaimReview 标记。

字段

字段
`name`	`string` 要删除的资源的名称，格式为 `pages/{page_id}`。

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`。空值表示不再有结果。

claims[]

Claim

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

next_page_token

string

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

GetClaimReviewMarkupPageRequest

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

字段

字段
`name`	`string` 要获取的资源的名称，格式为 `pages/{page_id}`。

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`。空值表示不再有结果。

claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview 标记的网页结果列表。

next_page_token

string

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

发布者

发布商的相关信息。

字段

字段
`name`	`string` 此发布商的名称。例如，“Awesome Fact Checks”。
`site`	`string` 主机级网站名称，不带协议或“www”前缀。例如，“awesomefactchecks.com”。此字段的值完全基于声明审核网址。

name

string

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

site

string

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

UpdateClaimReviewMarkupPageRequest 类中的方法

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

字段

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

claim_review_markup_page

ClaimReviewMarkupPage

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