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 不一致(如果相应标记自上次读取后发生了修改,就可能会发生这种情况),此请求将会失败。同时,也不能更改网页网址。如需更改标记的网址,请删除旧标记,然后使用新网址重新创建标记。