Package google.factchecking.factchecktools.v1alpha1

Chỉ mục

Công cụ xác minh tính xác thực

API công cụ xác minh tính xác thực

API Công cụ xác minh tính xác thực cung cấp quyền truy cập 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 Công cụ xác minh tính xác thực của Google tại https://g.co/factchecktools.

Các API hiện tại có sẵn là:

  • Tìm kiếm xác nhận quyền sở hữu đã được 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 xác minh tính xác thực đã xác minh).

  • 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 xác minh tính xác thực).

Tạo ONIXMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

Phạm vi cấp phép

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

  • https://www.googleapis.com/auth/userinfo.email
XóaClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

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

Phạm vi cấp phép

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

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

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Tìm kiếm thông qua những tuyên bố đã được xác minh tính xác thực.
Nhận

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

Phạm vi cấp phép

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

  • https://www.googleapis.com/auth/userinfo.email
Danh sách

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Hãy 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 cấp phép

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

  • https://www.googleapis.com/auth/userinfo.email
Cập nhật ONIXMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

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 Nhận, sau đó sửa đổi mã đánh dấu được trả về và cuối cùng gọi Cập nhật bằng toàn bộ mã đánh dấu ClaimReview làm phần nội dung.

Phạm vi cấp phép

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

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

Đặt phòng

Thông tin về tuyên bố.

Các trường
text

string

Văn bản xác nhận quyền sở hữu. Ví dụ: "Crime đã tăng gấp đôi trong 2 năm qua."

claimant

string

Một cá nhân hoặc tổ chức tuyên bố. Ví dụ: "John Doe"

claim_date

Timestamp

Ngày đưa ra tuyên bố.

claim_review[]

ClaimReview

Ít nhất một 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).

Thông báo xác nhận quyền sở hữu tác giả

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

Các trường
name

string

Một cá nhân hoặc tổ chức 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.

Xếp hạng

Thông tin về điểm xếp hạng của thông báo xác nhận quyền sở hữu.

Các trường
textual_rating

string

Mục đánh giá về độ chính xác của một từ hoặc cụm từ ngắn dễ đọc.
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 thuộc tính ⇥ — mức xếp hạng cao nhất.
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ề quy trình xem xét thông báo xác nhận quyền sở hữu.

Các trường
publisher

Publisher

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

url

string

URL của quy trình xem xét thông báo xác nhận quyền sở hữu này.

title

string

Tiêu đề của bài đánh giá này có thể xác định được.

review_date

Timestamp

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

textual_rating

string

Xếp hạng văn bản. Ví dụ: "Hầu như sai"

language_code

string

Ngôn ngữ viết bài đánh giá này. Ví dụ: "en" hoặc "de"

ClaimReviewAuthor

Thông tin về tác giả bài đánh giá xác nhận quyền sở hữu.

Các 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.

Đánh dấu ClaimReview

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

Các trường
url

string

Trường này là 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 đè là URL trang cộng với liên kết cố định tùy chọn ("page Jump").
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 đưa ra hoặc tuyên bố công khai tuyên bố.
Tương ứng với ClaimReview.itemReviewed.datePublished.

claim_location

string

Vị trí đưa ra tuyên bố này.
Tương ứng với ClaimReview.itemReviewed.name.

claim_first_appearance

string

Đường liên kết đến tác phẩm mà khiếu nại này xuất hiện lần đầu tiên.
Tương ứng với ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Danh sách đường liên kết đến các công việc mà tuyên bố này xuất hiện, ngoài đường liên kết đượ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 thông báo xác nhận quyền sở hữu này.

rating

ClaimRating

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

ClaimReviewMarkupPage

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

Các trường
name

string

Tên của tài nguyên trang đánh dấu ClaimReview này, dưới dạng pages/{page_id}. Ngoại trừ các yêu cầu cập nhật, trường này chỉ có kết quả đầu ra và người dùng không nên đặt trường này.

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 riêng lẻ đều có trường URL riêng, nhưng về mặt ngữ nghĩa, đây là trường cấp trang và mỗi ClaimReview trên trang này sẽ sử dụng giá trị này, trừ trường hợp bị ghi đè riêng.
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à 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á tuyên bố 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ác giá trị giống nhau.

claim_review_markups[]

ClaimReviewMarkup

Danh sách từng bài đánh giá về thông báo xác nhận quyền sở hữu trên trang này. Mỗi mục trong danh sách này 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ó kết quả đầu ra và người dùng không nên đặt trường này.

Tạo AdXMarkupPageRequest

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

Các trường
claim_review_markup_page

ClaimReviewMarkupPage

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

XóaClaimReviewMarkupPageRequest

Yêu cầu xóa toàn bộ mã đánh dấu ClaimReview trên một trang.

Các trường
name

string

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

FactCheckClaimSearchRequest

Yêu cầu tìm kiếm thông qua những tuyên bố đã được xác minh tính xác thực.

Các trường
query

string

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

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ù chúng tôi hiện không xem xét khu vực đó.

review_publisher_site_filter

string

Trang web của nhà xuất bản đánh giá dùng để lọc kết quả, ví dụ như Voyager.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 xác nhận quyền sở hữu hoặc ngày xem xét, tùy 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 kết quả đó. Giá trị 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ừ yêu cầu Danh sách trước đó (nếu có) để lấy trang tiếp theo. Tất cả các trường khác phải có giá trị giống như trong yêu cầu trước.

offset

int32

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

Thông tin xác minh tính xác thực xác thực

Phản hồi từ việc tìm kiếm các tuyên bố đã được xác minh tính xác thực.

Các 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 có liên quan đến các thông báo đó.

next_page_token

string

Mã phân trang tiếp theo trong phản hồi Tìm kiếm. Bạn nên dùng tên 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ận ONIXMarkupPageRequest

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

Các trường
name

string

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

Danh sách

Yêu cầu liệt kê mã đánh dấu ClaimReview.

Các trường
url

string

URL mà từ đó bạn lấy được mã đánh dấu ClaimReview. Sẽ có tối đa một kết quả. Nếu mã đánh dấu liên kết với một phiên bản URL chính tắc khác đã cung cấp, 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 tôi muốn tìm nạp mã đánh dấu. Ví dụ: "site.com" Không thể chỉ định cùng với URL.

page_size

int32

Kích thước phân trang. Chúng tôi sẽ trả về tối đa kết quả đó. Giá trị mặc định là 10 nếu không được đặt. Không có tác dụng nếu URL được yêu cầu.

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ừ yêu cầu Danh sách trước đó (nếu có) để lấy trang tiếp theo. Tất cả các trường khác phải có giá trị giống như trong yêu cầu trước.

offset

int32

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

Danh sáchClaimReviewMarkupPagesResponse

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

Các trường
claim_review_markup_pages[]

ClaimReviewMarkupPage

Danh sách kết quả gồm các trang đánh dấu ClaimReview.

next_page_token

string

Mã phân trang tiếp theo trong phản hồi Tìm kiếm. Bạn nên dùng tên 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.

Các trường
name

string

Tên nhà xuất bản này. Ví dụ: "Awesome Fact Checks"

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ố &wwwt.www" Ví dụ: "awesomefactchecks.com" Giá trị của trường này chỉ dựa trên URL xem xét thông báo xác nhận quyền sở hữu.

Cập nhật ONIXMarkupPageRequest

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

Các trường
claim_review_markup_page

ClaimReviewMarkupPage

Mã đánh dấu ClaimReview được cập nhật cho trang này. Các 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ã phiên bản được chỉ định không khớp với mã phiên bản của mã đánh dấu mới nhất (có thể xảy ra nếu mã đánh dấu đã được sửa đổi kể từ lần đọc gần nhất), thì yêu cầu này sẽ không thành công. Bản 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 xóa mã đánh dấu cũ rồi tạo lại bằng URL mới.