Package google.factchecking.factchecktools.v1alpha1

索引

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

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 操作，然后修改返回的标记，最后调用 Update 并将整个 ClaimReview 标记作为正文。 授权范围 需要以下 OAuth 范围： https://www.googleapis.com/auth/factchecktools

领取

有关版权主张的信息。

字段
text	string 声明文本。例如，“过去 2 年内，犯罪率翻了一番。”
claimant	string 提出声明的个人或组织。例如，“John Doe”。
claim_date	Timestamp 提出版权主张的日期。
claim_review[]	ClaimReview 针对相应声明的一篇或多篇评价（即事实核查文章）。

ClaimAuthor

声明作者的相关信息。

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

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 搜索响应中的下一个分页令牌。它应该用作后续请求的 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 搜索响应中的下一个分页令牌。它应该用作后续请求的 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 搜索响应中的下一个分页令牌。它应该用作后续请求的 page_token。空值表示不再有结果。

发布商

发布商的相关信息。

字段
name	string 相应出版商的名称。例如，“Awesome Fact Checks”。
site	string 主机级网站名称，不含协议或“www”前缀。例如，“awesomefactchecks.com”。此字段的值完全基于版权主张审核网址。

UpdateClaimReviewMarkupPageRequest

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

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