Package google.factchecking.factchecktools.v1alpha1

Indeks

FactCheckToolsService

Fact Check Tools API

Fact Check Tools API memberikan akses terprogram ke fungsi yang disediakan melalui frontend Alat Cek Fakta Google di https://g.co/factchecktools.

API yang tersedia saat ini adalah:

  • Penelusuran Klaim yang telah Diverifikasi Faktanya (disediakan melalui frontend Penjelajah Cek Fakta).
  • Penelusuran Klaim yang telah Diverifikasi Fakta berdasarkan Gambar (disediakan melalui frontend Penjelajah Cek Fakta).

  • Antarmuka CRUD untuk markup ClaimReview di halaman (disediakan melalui frontend Alat Markup Cek Fakta).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Buat markup ClaimReview di halaman.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Hapus semua markup ClaimReview di halaman.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Telusuri klaim yang telah dicek faktanya menggunakan gambar sebagai kueri.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Telusuri klaim yang telah dicek faktanya.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Mendapatkan semua markup ClaimReview di halaman.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Mencantumkan halaman markup ClaimReview untuk URL tertentu atau untuk organisasi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Memperbarui semua markup ClaimReview di halaman

Perhatikan bahwa ini adalah update penuh. Untuk mempertahankan markup ClaimReview yang ada di halaman, lakukan operasi Get terlebih dahulu, lalu ubah markup yang ditampilkan, dan terakhir panggil Update dengan seluruh markup ClaimReview sebagai isi.

Cakupan otorisasi

Memerlukan cakupan OAuth berikut:

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

Klaim

Informasi tentang klaim.

Kolom
text

string

Teks klaim. Misalnya, "Kejahatan meningkat dua kali lipat dalam 2 tahun terakhir".
claimant

string

Orang atau organisasi yang menyatakan klaim. Misalnya, "John Doe".
claim_date

Timestamp

Tanggal klaim dibuat.
claim_review[]

ClaimReview

Satu atau beberapa ulasan tentang klaim ini (yaitu, artikel cek fakta).

ClaimAuthor

Informasi tentang penulis klaim.

Kolom
name

string

Orang atau organisasi yang menyatakan klaim. Misalnya, "John Doe".
Sesuai dengan ClaimReview.itemReviewed.author.name.
job_title

string

Sesuai dengan ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Sesuai dengan ClaimReview.itemReviewed.author.image.
same_as

string

Sesuai dengan ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informasi tentang rating klaim.

Kolom
textual_rating

string

Tingkat kebenaran sebagai kata atau frasa singkat yang dapat dibaca manusia.
Sesuai dengan ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Rating numerik untuk klaim ini, mulai dari worstRating — bestRating inklusif.
Sesuai dengan ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Untuk rating numerik, kemungkinan nilai terburuknya dalam skala dari paling buruk hingga paling baik.
Sesuai dengan ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Untuk rating numerik, kemungkinan nilai terbaiknya dalam skala dari paling buruk hingga paling baik.
Sesuai dengan ClaimReview.reviewRating.bestRating.
rating_explanation

string

Sesuai dengan ClaimReview.reviewRating.ratingExplanation.
image_url

string

Sesuai dengan ClaimReview.reviewRating.image.

ClaimReview

Informasi tentang peninjauan klaim.

Kolom
publisher

Publisher

Penerbit ulasan klaim ini.
url

string

URL ulasan klaim ini.
title

string

Judul ulasan klaim ini, jika dapat ditentukan.
review_date

Timestamp

Tanggal klaim ditinjau.
textual_rating

string

Rating tekstual. Misalnya, "Sebagian besar salah".
language_code

string

Bahasa yang digunakan untuk menulis ulasan ini. Misalnya, "en" atau "de".

ClaimReviewAuthor

Informasi tentang penulis ulasan klaim.

Kolom
name

string

Nama organisasi yang memublikasikan cek fakta.
Sesuai dengan ClaimReview.author.name.
image_url

string

Sesuai dengan ClaimReview.author.image.

ClaimReviewMarkup

Kolom untuk setiap elemen ClaimReview. Kecuali untuk sub-pesan yang mengelompokkan kolom, setiap kolom ini sesuai dengan kolom di https://schema.org/ClaimReview. Kami mencantumkan pemetaan yang tepat untuk setiap kolom.

Kolom
url

string

Kolom ini bersifat opsional, dan secara default akan menggunakan URL halaman. Kami menyediakan kolom ini agar Anda dapat mengganti nilai default, tetapi satu-satunya penggantian yang diizinkan adalah URL halaman ditambah link anchor opsional ("lompatan halaman").
Sesuai dengan ClaimReview.url
claim_reviewed

string

Ringkasan singkat tentang klaim yang sedang dievaluasi.
Sesuai dengan ClaimReview.claimReviewed.
claim_date

string

Tanggal pembuatan klaim atau ketika klaim menjadi wacana publik.
Sesuai dengan ClaimReview.itemReviewed.datePublished.
claim_location

string

Lokasi tempat klaim ini dibuat.
Sesuai dengan ClaimReview.itemReviewed.name.
claim_first_appearance

string

Link ke karya tempat klaim ini pertama kali muncul.
Sesuai dengan ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Daftar link ke karya yang memuat klaim ini, selain yang ditentukan dalam claim_first_appearance.
Sesuai dengan ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Info tentang penulis klaim ini.
rating

ClaimRating

Info tentang rating ulasan klaim ini.

ClaimReviewMarkupPage

Berisi satu atau beberapa instance markup ClaimReview untuk halaman web.

Kolom
name

string

Nama resource halaman markup ClaimReview ini, dalam bentuk pages/{page_id}. Kecuali untuk permintaan update, kolom ini hanya berupa output dan tidak boleh ditetapkan oleh pengguna.
page_url

string

URL halaman yang terkait dengan markup ClaimReview ini. Meskipun setiap ClaimReview memiliki kolom URL sendiri, secara semantik ini adalah kolom tingkat halaman, dan setiap ClaimReview di halaman ini akan menggunakan nilai ini kecuali jika diganti satu per satu.
Sesuai dengan ClaimReview.url
publish_date

string

Tanggal saat cek fakta dipublikasikan. Mirip dengan URL, secara semantik, ini adalah kolom tingkat halaman, dan setiap ClaimReview di halaman ini akan berisi nilai yang sama.
Sesuai dengan ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Info tentang penulis ulasan klaim ini. Mirip dengan di atas, secara semantik, ini adalah kolom tingkat halaman, dan setiap ClaimReview di halaman ini akan berisi nilai yang sama.
claim_review_markups[]

ClaimReviewMarkup

Daftar ulasan klaim individual untuk halaman ini. Setiap item dalam daftar sesuai dengan satu elemen ClaimReview.
version_id

string

ID versi untuk markup ini. Kecuali untuk permintaan update, kolom ini hanya berupa output dan tidak boleh ditetapkan oleh pengguna.

CreateClaimReviewMarkupPageRequest

Permintaan untuk membuat markup ClaimReview di halaman.

Kolom
claim_review_markup_page

ClaimReviewMarkupPage

Markup ClaimReview yang akan dibuat untuk halaman ini. Jika ada versi URL halaman yang lebih kanonis yang diberikan, kami akan menggunakan versi tersebut.

DeleteClaimReviewMarkupPageRequest

Permintaan untuk menghapus semua markup ClaimReview di halaman.

Kolom
name

string

Nama resource yang akan dihapus, dalam bentuk pages/{page_id}.

FactCheckedClaimImageSearchRequest

Permintaan untuk menelusuri klaim yang telah dicek faktanya menurut gambar.

Kolom
image_uri

string

Wajib. URI gambar sumber. Ini harus berupa URL HTTP/HTTPS gambar yang dapat diakses secara publik.

Saat mengambil gambar dari URL HTTP/HTTPS, Google tidak dapat menjamin bahwa permintaan akan diselesaikan. Permintaan Anda mungkin gagal jika host yang ditentukan menolak permintaan tersebut (mis. karena throttling permintaan atau pencegahan DOS), atau jika Google men-throttle permintaan ke situs untuk pencegahan penyalahgunaan. Anda tidak boleh bergantung pada gambar yang dihosting secara eksternal untuk aplikasi produksi.
language_code

string

Opsional. Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Dapat digunakan untuk membatasi hasil menurut bahasa, meskipun saat ini kami tidak mempertimbangkan wilayah.
page_size

int32

Opsional. Ukuran penomoran halaman. Kami akan menampilkan hingga sebanyak itu hasil. Jika tidak ditetapkan, defaultnya adalah 10.
page_token

string

Opsional. Token penomoran halaman. Anda dapat memberikan next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada, untuk mendapatkan halaman berikutnya. Semua kolom lainnya harus memiliki nilai yang sama seperti pada permintaan sebelumnya.
offset

int32

Opsional. Bilangan bulat yang menentukan offset saat ini (yaitu, lokasi hasil awal) dalam hasil penelusuran. Kolom ini hanya dipertimbangkan jika page_token tidak ditetapkan. Misalnya, 0 berarti menampilkan hasil mulai dari hasil yang cocok pertama, dan 10 berarti menampilkan hasil mulai dari hasil ke-11.

FactCheckedClaimImageSearchResponse

Respons dari penelusuran klaim yang telah dicek faktanya berdasarkan gambar.

Kolom
results[]

Result

Daftar klaim dan semua informasi terkaitnya.
next_page_token

string

Token penomoran halaman berikutnya dalam respons Penelusuran. Nilai ini harus digunakan sebagai page_token untuk permintaan berikut. Nilai kosong berarti tidak ada lagi hasil.

Hasil

Klaim dan informasi terkaitnya.

Kolom
claim

Claim

Klaim yang cocok dengan kueri.

FactCheckedClaimSearchRequest

Permintaan untuk menelusuri klaim yang telah dicek faktanya.

Kolom
query

string

String kueri tekstual. Wajib ada kecuali jika review_publisher_site_filter ditentukan.
language_code

string

Kode bahasa BCP-47, seperti "en-US" atau "sr-Latn". Dapat digunakan untuk membatasi hasil menurut bahasa, meskipun saat ini kami tidak mempertimbangkan wilayah.
review_publisher_site_filter

string

Situs penayang ulasan untuk memfilter hasil menurutnya, misalnya nytimes.com.
max_age_days

int32

Usia maksimum hasil penelusuran yang ditampilkan, dalam hari. Usia ditentukan oleh tanggal klaim atau tanggal ulasan, mana saja yang lebih baru.
page_size

int32

Ukuran penomoran halaman. Kami akan menampilkan hingga sebanyak itu hasil. Jika tidak ditetapkan, defaultnya adalah 10.
page_token

string

Token penomoran halaman. Anda dapat memberikan next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada, untuk mendapatkan halaman berikutnya. Semua kolom lainnya harus memiliki nilai yang sama seperti pada permintaan sebelumnya.
offset

int32

Bilangan bulat yang menentukan offset saat ini (yaitu, lokasi hasil awal) dalam hasil penelusuran. Kolom ini hanya dipertimbangkan jika page_token tidak ditetapkan. Misalnya, 0 berarti menampilkan hasil mulai dari hasil yang cocok pertama, dan 10 berarti menampilkan hasil mulai dari hasil ke-11.

FactCheckedClaimSearchResponse

Respons dari penelusuran klaim yang telah dicek faktanya.

Kolom
claims[]

Claim

Daftar klaim dan semua informasi terkaitnya.
next_page_token

string

Token penomoran halaman berikutnya dalam respons Penelusuran. Nilai ini harus digunakan sebagai page_token untuk permintaan berikut. Nilai kosong berarti tidak ada lagi hasil.

GetClaimReviewMarkupPageRequest

Permintaan untuk mendapatkan markup ClaimReview di halaman.

Kolom
name

string

Nama resource yang akan didapatkan, dalam bentuk pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Permintaan untuk markup ClaimReview listingan.

Kolom
url

string

URL tempat markup ClaimReview akan diambil. Paling banyak akan ada satu hasil. Jika markup dikaitkan dengan versi URL yang lebih kanonis dari URL yang diberikan, kami akan menampilkan URL tersebut. Tidak dapat ditentukan bersama dengan organisasi.
organization

string

Organisasi yang markupnya ingin kita ambil. Misalnya, "site.com". Tidak dapat ditentukan bersama dengan URL.
page_size

int32

Ukuran penomoran halaman. Kami akan menampilkan hingga sebanyak itu hasil. Jika tidak ditetapkan, defaultnya adalah 10. Tidak berpengaruh jika URL diminta.
page_token

string

Token penomoran halaman. Anda dapat memberikan next_page_token yang ditampilkan dari permintaan Daftar sebelumnya, jika ada, untuk mendapatkan halaman berikutnya. Semua kolom lainnya harus memiliki nilai yang sama seperti pada permintaan sebelumnya.
offset

int32

Bilangan bulat yang menentukan offset saat ini (yaitu, lokasi hasil awal) dalam hasil penelusuran. Kolom ini hanya dipertimbangkan jika page_token tidak ditetapkan, dan jika permintaan bukan untuk URL tertentu. Misalnya, 0 berarti menampilkan hasil mulai dari hasil yang cocok pertama, dan 10 berarti menampilkan hasil mulai dari hasil ke-11.

ListClaimReviewMarkupPagesResponse

Respons dari markup listingan ClaimReview.

Kolom
claim_review_markup_pages[]

ClaimReviewMarkupPage

Daftar hasil halaman dengan markup ClaimReview.
next_page_token

string

Token penomoran halaman berikutnya dalam respons Penelusuran. Nilai ini harus digunakan sebagai page_token untuk permintaan berikut. Nilai kosong berarti tidak ada lagi hasil.

Penerbit

Informasi tentang penayang.

Kolom
name

string

Nama penayang ini. Misalnya, "Pemeriksaan Fakta Keren".
site

string

Nama situs tingkat host, tanpa awalan protokol atau "www". Misalnya, "awesomefactchecks.com". Nilai kolom ini hanya didasarkan pada URL peninjauan klaim.

UpdateClaimReviewMarkupPageRequest

Permintaan untuk memperbarui semua markup ClaimReview di halaman.

Kolom
claim_review_markup_page

ClaimReviewMarkupPage

Markup ClaimReview yang diperbarui untuk halaman ini. Permintaan pembaruan harus menentukan nama resource dan ID versi resource yang akan diperbarui. Jika ID versi yang ditentukan tidak cocok dengan ID versi markup terbaru (yang dapat terjadi jika markup telah diubah sejak terakhir dibaca), permintaan ini akan gagal. Pembaruan juga tidak boleh mengubah URL halaman. Untuk mengubah URL markup, hapus markup lama dan buat ulang dengan URL baru.