Package google.factchecking.factchecktools.v1alpha1

Indeks

Layanan Alat Fakta

API Alat Fakta

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

API yang tersedia saat ini adalah:

  • Penelusuran Klaim Cek Fakta (disediakan melalui frontend Penjelajah Cek Fakta).

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

MembuatClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Buat markup ClaimReview pada halaman.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Menghapus semua markup ClaimReview di halaman.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Menelusuri melalui klaim cek fakta.

GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Dapatkan semua markup ClaimReview di satu halaman.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Buat daftar halaman markup ClaimReview untuk URL tertentu atau untuk organisasi.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Pembaruan untuk semua markup ClaimReview di halaman

Perlu diperhatikan bahwa ini adalah update lengkap. Untuk mempertahankan markup ClaimReview yang ada di halaman, pertama-tama lakukan operasi Get, lalu ubah markup yang ditampilkan, dan terakhir panggil Update dengan seluruh markup ClaimReview sebagai isi.

Cakupan Otorisasi

Memerlukan cakupan OAuth berikut ini:

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

Klaim

Informasi tentang klaim.

Kolom
text

string

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

claimant

string

Orang atau organisasi yang mengklaim klaim tersebut. Misalnya, "Budi Budiman".

claim_date

Timestamp

Tanggal klaim dibuat.

claim_review[]

ClaimReview

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

KlaimPenulis

Informasi tentang penulis klaim.

Kolom
name

string

Orang atau organisasi yang mengklaim klaim tersebut. Misalnya, "Budi Budiman".
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.

RatingKlaim

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, dalam rentang terburukRating — 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 tinjauan klaim ini.

url

string

URL dari peninjauan klaim ini.

title

string

Judul tinjauan 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, "id" atau "de".

Pengawas ClaimReview

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.

MarkupClaimReview

Kolom untuk elemen ClaimReview individual. Kecuali untuk sub-pesan yang mengelompokkan kolom secara bersamaan, setiap kolom tersebut sesuai dengan yang ada 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 untuk mengizinkan Anda mengganti nilai default, tetapi satu-satunya penggantian yang diizinkan adalah URL halaman dan link anchor opsional ("page jump").
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 yang pertama kali menampilkan klaim ini.
Sesuai dengan ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Daftar link ke lokasi munculnya klaim ini, selain dari link yang ditentukan di 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

Menyimpan satu atau beberapa 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 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 diganti satu per satu.
Sesuai dengan ClaimReview.url

publish_date

string

Tanggal saat cek fakta dipublikasikan. Serupa 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. Serupa 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 tinjauan 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 output dan tidak boleh ditetapkan oleh pengguna.

MembuatClaimReviewMarkupPageRequest

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 URL tersebut sebagai gantinya.

MenghapusClaimReviewMarkupPageRequest

Permintaan untuk menghapus semua markup ClaimReview di halaman.

Kolom
name

string

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

FactCheckClaimSearchRequest

Permintaan untuk menelusuri klaim dengan cek fakta.

Kolom
query

string

String kueri tekstual. Wajib, 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 tersebut.

review_publisher_site_filter

string

Situs penayang ulasan untuk memfilter hasil menurut, mis, nytimes.com.

max_age_days

int32

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

page_size

int32

Ukuran penomoran halaman. Kami akan menampilkan hingga hasil sebanyak itu. Jika tidak ditetapkan, setelan 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 lain harus memiliki nilai yang sama dengan permintaan sebelumnya.

offset

int32

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

FactCheckClaimSearchResponse

Respons dari penelusuran klaim dengan cek fakta.

Kolom
claims[]

Claim

Daftar klaim dan semua informasi terkait.

next_page_token

string

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

GetClaimReviewMarkupPageRequest

Permintaan untuk mendapatkan markup ClaimReview di halaman.

Kolom
name

string

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

MencantumkanClaimReviewMarkupPageRequest

Permintaan untuk mencantumkan markup ClaimReview.

Kolom
url

string

URL tempat untuk mendapatkan markup ClaimReview. Maksimal hanya akan ada satu hasil. Jika markup dikaitkan dengan versi URL yang lebih kanonis yang diberikan, kami akan menampilkan URL tersebut. Tidak dapat ditentukan bersama dengan organisasi.

organization

string

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

page_size

int32

Ukuran penomoran halaman. Kami akan menampilkan hingga hasil sebanyak itu. Jika tidak ditetapkan, setelan 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 lain harus memiliki nilai yang sama dengan permintaan sebelumnya.

offset

int32

Bilangan bulat yang menentukan offset saat ini (yaitu, lokasi hasil awal) di 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 pencocokan pertama, dan 10 berarti menampilkan hasil dari hasil ke-11.

MencantumkanClaimReviewMarkupPageResponse

Respons dari markup ClaimReview listingan.

Kolom
claim_review_markup_pages[]

ClaimReviewMarkupPage

Daftar hasil markup ClaimReview.

next_page_token

string

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

Penayang

Informasi tentang penayang.

Kolom
name

string

Nama penerbit ini. Misalnya, "Cek Fakta Luar Biasa".

site

string

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

MengupdateClaimReviewMarkupPageRequest

Permintaan untuk memperbarui semua markup ClaimReview di halaman.

Kolom
claim_review_markup_page

ClaimReviewMarkupPage

Markup ClaimReview yang diperbarui untuk halaman ini. Permintaan update harus menentukan nama resource dan ID versi resource yang ingin diupdate. Jika ID versi yang ditentukan tidak cocok dengan ID versi markup terbaru (yang mungkin 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.