Package google.factchecking.factchecktools.v1alpha1

Chỉ mục

FactCheckToolsService

Fact Check Tools API

Fact Check Tools API cung cấp quyền truy cập theo phương thức có lập trình vào chức năng được cung cấp thông qua giao diện người dùng của Google Fact Check Tools tại https://g.co/factchecktools.

Các API hiện có là:

  • Tính năng tìm kiếm thông tin xác minh tính xác thực (được cung cấp thông qua giao diện người dùng của Trình khám phá thông tin xác minh tính xác thực).
  • Tìm kiếm tuyên bố đã được kiểm chứng theo hình ảnh (được cung cấp thông qua giao diện người dùng của Trình khám phá thông tin kiểm chứng).

  • Giao diện CRUD cho mã đánh dấu ClaimReview trên một trang (được cung cấp thông qua giao diện người dùng của Công cụ đánh dấu thông tin kiểm chứng).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Tạo mã đánh dấu ClaimReview trên một trang.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/factchecktools
DeleteClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Xoá tất cả nội dung đánh dấu ClaimReview trên một trang.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/factchecktools
FactCheckedClaimImageSearch

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Tìm kiếm thông tin đã được kiểm chứng bằng cách dùng hình ảnh làm cụm từ tìm kiếm.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Tìm kiếm các tuyên bố đã được kiểm chứng.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Nhận tất cả mã đánh dấu ClaimReview trên một trang.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/factchecktools
ListClaimReviewMarkupPages

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Liệt kê các trang đánh dấu ClaimReview cho một URL cụ thể hoặc cho một tổ chức.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/factchecktools
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Cập nhật cho tất cả mã đánh dấu ClaimReview trên một trang

Xin lưu ý rằng đây là bản cập nhật đầy đủ. Để giữ lại mã đánh dấu ClaimReview hiện có trên một trang, trước tiên, hãy thực hiện thao tác Get, sau đó sửa đổi mã đánh dấu được trả về và cuối cùng gọi Update với toàn bộ mã đánh dấu ClaimReview làm nội dung.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/factchecktools

Xác nhận quyền sở hữu

Thông tin về thông báo xác nhận quyền sở hữu.

Trường
text

string

Văn bản tuyên bố. Ví dụ: "Tội phạm đã tăng gấp đôi trong 2 năm qua".
claimant

string

Cá nhân hoặc tổ chức đưa ra tuyên bố. Ví dụ: "John Doe".
claim_date

Timestamp

Ngày đưa ra đơn kiện.
claim_review[]

ClaimReview

Một hoặc nhiều bài đánh giá về tuyên bố này (cụ thể là một bài viết xác minh tính xác thực).

ClaimAuthor

Thông tin về tác giả của tuyên bố.

Trường
name

string

Cá nhân hoặc tổ chức đưa ra tuyên bố. Ví dụ: "John Doe".
Tương ứng với ClaimReview.itemReviewed.author.name.
job_title

string

Tương ứng với ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Tương ứng với ClaimReview.itemReviewed.author.image.
same_as

string

Tương ứng với ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Thông tin về điểm đánh giá thông tin xác nhận quyền sở hữu.

Trường
textual_rating

string

Mục đánh giá về độ chính xác dưới dạng một từ hoặc cụm từ ngắn dễ hiểu.
Tương ứng với ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Điểm đánh giá dạng số về tuyên bố này, trong phạm vi từ worstRating đến bestRating (bao gồm cả hai giá trị này).
Tương ứng với ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Đối với điểm đánh giá dạng số, đây là giá trị thấp nhất có thể trong thang điểm từ thấp nhất đến cao nhất.
Tương ứng với ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Đối với điểm đánh giá dạng số, đây là giá trị cao nhất có thể trong thang điểm từ thấp nhất đến cao nhất.
Tương ứng với ClaimReview.reviewRating.bestRating.
rating_explanation

string

Tương ứng với ClaimReview.reviewRating.ratingExplanation.
image_url

string

Tương ứng với ClaimReview.reviewRating.image.

ClaimReview

Thông tin về yêu cầu xem xét đơn kiện.

Trường
publisher

Publisher

Nhà xuất bản của bài đánh giá về tuyên bố này.
url

string

URL của yêu cầu xem xét này.
title

string

Tiêu đề của bản đánh giá này về thông tin xác nhận quyền sở hữu (nếu có thể xác định).
review_date

Timestamp

Ngày thông báo xác nhận quyền sở hữu được xem xét.
textual_rating

string

Mức phân loại bằng văn bản. Ví dụ: "Hầu hết là sai".
language_code

string

Ngôn ngữ được sử dụng trong bài đánh giá này. Ví dụ: "en" hoặc "de".

ClaimReviewAuthor

Thông tin về tác giả bài đánh giá tuyên bố.

Trường
name

string

Tên của tổ chức xuất bản bài xác minh tính xác thực.
Tương ứng với ClaimReview.author.name.
image_url

string

Tương ứng với ClaimReview.author.image.

ClaimReviewMarkup

Các trường cho từng phần tử ClaimReview. Ngoại trừ các thông báo phụ nhóm các trường lại với nhau, mỗi trường trong số này đều tương ứng với các trường trong https://schema.org/ClaimReview. Chúng tôi liệt kê thông tin liên kết chính xác cho từng trường.

Trường
url

string

Trường này không bắt buộc và sẽ mặc định là URL của trang. Chúng tôi cung cấp trường này để cho phép bạn ghi đè giá trị mặc định, nhưng chỉ được phép ghi đè URL trang cộng với một đường liên kết đến vị trí cụ thể không bắt buộc ("nhảy trang").
Tương ứng với ClaimReview.url
claim_reviewed

string

Tóm tắt ngắn về tuyên bố đang được đánh giá.
Tương ứng với ClaimReview.claimReviewed.
claim_date

string

Ngày mà tuyên bố được đưa ra hoặc phổ biến rộng rãi.
Tương ứng với ClaimReview.itemReviewed.datePublished.
claim_location

string

Vị trí nơi thông báo xác nhận quyền sở hữu này được đưa ra.
Tương ứng với ClaimReview.itemReviewed.name.
claim_first_appearance

string

Đường liên kết đến một tác phẩm có chứa tuyên bố này.
Tương ứng với ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Danh sách đường liên kết đến những tác phẩm mà tuyên bố này xuất hiện, ngoài tác phẩm được chỉ định trong claim_first_appearance.
Tương ứng với ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Thông tin về tác giả của tuyên bố này.
rating

ClaimRating

Thông tin về điểm xếp hạng của bài đánh giá tuyên bố này.

ClaimReviewMarkupPage

Lưu trữ một hoặc nhiều phiên bản của mã đánh dấu ClaimReview cho một trang web.

Trường
name

string

Tên của tài nguyên trang đánh dấu ClaimReview này, ở dạng pages/{page_id}. Ngoại trừ các yêu cầu cập nhật, trường này chỉ có thể xuất và người dùng không được đặt.
page_url

string

URL của trang được liên kết với mã đánh dấu ClaimReview này. Mặc dù mỗi ClaimReview đều có trường URL riêng, nhưng về mặt ngữ nghĩa, đây là một trường cấp trang và mỗi ClaimReview trên trang này sẽ sử dụng giá trị này, trừ phi bị ghi đè riêng lẻ.
Tương ứng với ClaimReview.url
publish_date

string

Ngày xuất bản bài xác minh tính xác thực. Tương tự như URL, về mặt ngữ nghĩa, đây là một trường cấp trang và mỗi ClaimReview trên trang này sẽ chứa cùng một giá trị.
Tương ứng với ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Thông tin về tác giả của bài đánh giá thông tin sai lệch này. Tương tự như ở trên, về mặt ngữ nghĩa, đây là các trường cấp trang và mỗi ClaimReview trên trang này sẽ chứa cùng một giá trị.
claim_review_markups[]

ClaimReviewMarkup

Danh sách các bài đánh giá tuyên bố riêng lẻ cho trang này. Mỗi mục trong danh sách tương ứng với một phần tử ClaimReview.
version_id

string

Mã phiên bản cho mã đánh dấu này. Ngoại trừ các yêu cầu cập nhật, trường này chỉ có thể xuất và người dùng không được đặt.

CreateClaimReviewMarkupPageRequest

Yêu cầu tạo mã đánh dấu ClaimReview trên một trang.

Trường
claim_review_markup_page

ClaimReviewMarkupPage

Mã đánh dấu ClaimReview cần tạo cho trang này. Nếu có phiên bản chính tắc hơn của URL trang được cung cấp, chúng tôi sẽ sử dụng phiên bản đó.

DeleteClaimReviewMarkupPageRequest

Yêu cầu xoá tất cả nội dung đánh dấu ClaimReview trên một trang.

Trường
name

string

Tên của tài nguyên cần xoá, ở dạng pages/{page_id}.

FactCheckedClaimImageSearchRequest

Yêu cầu tìm kiếm các tuyên bố đã được kiểm chứng bằng hình ảnh.

Trường
image_uri

string

Bắt buộc. URI của hình ảnh nguồn. Đây phải là một URL HTTP/HTTPS của hình ảnh có thể truy cập công khai.

Khi tìm nạp hình ảnh từ URL HTTP/HTTPS, Google không thể đảm bảo rằng yêu cầu sẽ được hoàn tất. Yêu cầu của bạn có thể không thành công nếu máy chủ lưu trữ được chỉ định từ chối yêu cầu (ví dụ: do điều tiết yêu cầu hoặc ngăn chặn DOS) hoặc nếu Google điều tiết các yêu cầu đến trang web để ngăn chặn hành vi sai trái. Bạn không nên phụ thuộc vào hình ảnh được lưu trữ bên ngoài cho các ứng dụng phát hành công khai.
language_code

string

Không bắt buộc. Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Có thể dùng để hạn chế kết quả theo ngôn ngữ, mặc dù hiện tại chúng tôi không xem xét khu vực.
page_size

int32

Không bắt buộc. Kích thước phân trang. Chúng tôi sẽ trả về tối đa số kết quả đó. Mặc định là 10 nếu không được đặt.
page_token

string

Không bắt buộc. Mã thông báo phân trang. Bạn có thể cung cấp next_page_token được trả về từ một yêu cầu Liệt kê trước đó (nếu có) để lấy trang tiếp theo. Tất cả các trường khác phải có cùng giá trị như trong yêu cầu trước đó.
offset

int32

Không bắt buộc. Một số nguyên chỉ định độ lệch hiện tại (tức là vị trí bắt đầu của kết quả) trong kết quả tìm kiếm. Trường này chỉ được xem xét nếu bạn chưa đặt page_token. Ví dụ: 0 có nghĩa là trả về kết quả bắt đầu từ kết quả trùng khớp đầu tiên và 10 có nghĩa là trả về từ kết quả thứ 11.

FactCheckedClaimImageSearchResponse

Kết quả tìm kiếm lời tuyên bố đã được kiểm chứng bằng hình ảnh.

Trường
results[]

Result

Danh sách các thông báo xác nhận quyền sở hữu và tất cả thông tin liên quan đến các thông báo đó.
next_page_token

string

Mã thông báo phân trang tiếp theo trong phản hồi Tìm kiếm. Bạn nên dùng mã này làm page_token cho yêu cầu sau. Giá trị trống có nghĩa là không có kết quả nào khác.

Kết quả

Thông báo xác nhận quyền sở hữu và thông tin liên quan.

Trường
claim

Claim

Một thông báo xác nhận quyền sở hữu khớp với cụm từ tìm kiếm.

FactCheckedClaimSearchRequest

Yêu cầu tìm kiếm các tuyên bố đã được kiểm chứng.

Trường
query

string

Chuỗi truy vấn dạng văn bản. Bắt buộc, trừ phi bạn chỉ định review_publisher_site_filter.
language_code

string

Mã ngôn ngữ BCP-47, chẳng hạn như "en-US" hoặc "sr-Latn". Có thể dùng để hạn chế kết quả theo ngôn ngữ, mặc dù hiện tại chúng tôi không xem xét khu vực.
review_publisher_site_filter

string

Trang web của nhà xuất bản bài đánh giá để lọc kết quả, ví dụ: nytimes.com.
max_age_days

int32

Độ tuổi tối đa của kết quả tìm kiếm được trả về (tính theo ngày). Tuổi được xác định theo ngày yêu cầu hoặc ngày đánh giá, tuỳ theo ngày nào mới hơn.
page_size

int32

Kích thước phân trang. Chúng tôi sẽ trả về tối đa số kết quả đó. Mặc định là 10 nếu không được đặt.
page_token

string

Mã thông báo phân trang. Bạn có thể cung cấp next_page_token được trả về từ một yêu cầu Liệt kê trước đó (nếu có) để lấy trang tiếp theo. Tất cả các trường khác phải có cùng giá trị như trong yêu cầu trước đó.
offset

int32

Một số nguyên chỉ định độ lệch hiện tại (tức là vị trí bắt đầu của kết quả) trong kết quả tìm kiếm. Trường này chỉ được xem xét nếu bạn chưa đặt page_token. Ví dụ: 0 có nghĩa là trả về kết quả bắt đầu từ kết quả trùng khớp đầu tiên và 10 có nghĩa là trả về từ kết quả thứ 11.

FactCheckedClaimSearchResponse

Câu trả lời khi tìm kiếm các tuyên bố đã được kiểm chứng.

Trường
claims[]

Claim

Danh sách các thông báo xác nhận quyền sở hữu và tất cả thông tin liên quan đến các thông báo đó.
next_page_token

string

Mã thông báo phân trang tiếp theo trong phản hồi Tìm kiếm. Bạn nên dùng mã này làm page_token cho yêu cầu sau. Giá trị trống có nghĩa là không có kết quả nào khác.

GetClaimReviewMarkupPageRequest

Yêu cầu lấy mã đánh dấu ClaimReview trên một trang.

Trường
name

string

Tên của tài nguyên cần lấy, ở dạng pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Yêu cầu về mã đánh dấu ClaimReview trong trang thông tin.

Trường
url

string

URL mà từ đó nhận được mã đánh dấu ClaimReview. Sẽ có tối đa một kết quả. Nếu mã đánh dấu được liên kết với một phiên bản chính tắc hơn của URL được cung cấp, thì chúng tôi sẽ trả về URL đó. Không thể chỉ định cùng với một tổ chức.
organization

string

Tổ chức mà chúng ta muốn tìm nạp các mã đánh dấu. Ví dụ: "site.com". Không thể chỉ định cùng với một URL.
page_size

int32

Kích thước phân trang. Chúng tôi sẽ trả về tối đa số kết quả đó. Mặc định là 10 nếu không được đặt. Không có hiệu lực nếu bạn yêu cầu một URL.
page_token

string

Mã thông báo phân trang. Bạn có thể cung cấp next_page_token được trả về từ một yêu cầu Liệt kê trước đó (nếu có) để lấy trang tiếp theo. Tất cả các trường khác phải có cùng giá trị như trong yêu cầu trước đó.
offset

int32

Một số nguyên chỉ định độ lệch hiện tại (tức là vị trí bắt đầu của kết quả) trong kết quả tìm kiếm. Trường này chỉ được xem xét nếu page_token chưa được đặt và nếu yêu cầu không phải cho một URL cụ thể. Ví dụ: 0 có nghĩa là trả về kết quả bắt đầu từ kết quả trùng khớp đầu tiên và 10 có nghĩa là trả về từ kết quả thứ 11.

ListClaimReviewMarkupPagesResponse

Phản hồi từ mã đánh dấu ClaimReview trong trang thông tin.

Trường
claim_review_markup_pages[]

ClaimReviewMarkupPage

Danh sách kết quả của các trang có mã đánh dấu ClaimReview.
next_page_token

string

Mã thông báo phân trang tiếp theo trong phản hồi Tìm kiếm. Bạn nên dùng mã này làm page_token cho yêu cầu sau. Giá trị trống có nghĩa là không có kết quả nào khác.

Nhà xuất bản

Thông tin về nhà xuất bản.

Trường
name

string

Tên của nhà xuất bản này. Ví dụ: "Awesome Fact Checks" (Kiểm chứng thông tin tuyệt vời).
site

string

Tên trang web ở cấp máy chủ lưu trữ, không có giao thức hoặc tiền tố "www". Ví dụ: "awesomefactchecks.com". Giá trị của trường này hoàn toàn dựa trên URL đánh giá thông tin xác nhận quyền sở hữu.

UpdateClaimReviewMarkupPageRequest

Yêu cầu cập nhật tất cả mã đánh dấu ClaimReview trên một trang.

Trường
claim_review_markup_page

ClaimReviewMarkupPage

Mã đánh dấu ClaimReview mới cho trang này. Yêu cầu cập nhật phải chỉ định cả tên tài nguyên và mã phiên bản của tài nguyên cần cập nhật. Nếu mã nhận dạng phiên bản được chỉ định không khớp với mã nhận dạng phiên bản của mã đánh dấu mới nhất (trường hợp này có thể xảy ra nếu mã đánh dấu đã được sửa đổi kể từ lần đọc gần đây nhất), thì yêu cầu này sẽ không thành công. Nội dung cập nhật cũng không được thay đổi URL của trang. Để thay đổi URL của mã đánh dấu, hãy xoá mã đánh dấu cũ rồi tạo lại mã đánh dấu đó bằng URL mới.