Package google.factchecking.factchecktools.v1alpha1

Dizin

FactCheckToolsService

Doğruluk Kontrolü Araçları API'si

Fact Check Tools API, https://g.co/factchecktools adresindeki Google Fact Check Tools ön ucu üzerinden sağlanan işlevlere programatik erişim imkanı sunar.

Şu anda kullanılabilen API'ler:

  • Doğruluğu Kontrol Edilmiş İddia Arama (Doğruluk Kontrolü Gezgini ön ucu aracılığıyla sağlanır).
  • Resimle Doğruluk Kontrolü Yapılmış İddia Arama (Doğruluk Kontrolü Gezgini ön ucu aracılığıyla sağlanır).

  • Bir sayfadaki ClaimReview işaretlemesi için CRUD arayüzü (Doğruluk Kontrolü İşaretleme Aracı ön ucu aracılığıyla sağlanır).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Bir sayfada ClaimReview işaretlemesi oluşturun.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Sayfadaki tüm ClaimReview işaretlemelerini silin.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Sorgu olarak resim kullanarak doğruluk kontrolü yapılmış iddialar arasında arama yapın.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Doğruluk kontrolü yapılmış iddialar arasında arama yapın.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Bir sayfadaki tüm ClaimReview işaretlemelerini alın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Belirli bir URL veya kuruluş için ClaimReview işaretleme sayfalarını listeleyin.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Bir sayfadaki tüm ClaimReview işaretlemeleri için güncelleme

Bu işlemin tam bir güncelleme olduğunu unutmayın. Bir sayfadaki mevcut ClaimReview işaretlemesini korumak için önce bir Get işlemi gerçekleştirin, ardından döndürülen işaretlemeyi değiştirin ve son olarak gövde olarak tüm ClaimReview işaretlemesiyle Update'i çağırın.

Yetkilendirme kapsamları

Aşağıdaki OAuth kapsamını gerektirir:

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

İddia

Hak talebi hakkında bilgiler.

Alanlar
text

string

İddia metni. Örneğin, "Suç oranı son 2 yılda iki katına çıktı."
claimant

string

İddiayı belirten kişi veya kuruluş. Örneğin, "Ahmet Demir".
claim_date

Timestamp

Hak talebinin oluşturulduğu tarih.
claim_review[]

ClaimReview

Bu iddiayla ilgili bir veya daha fazla inceleme (ör. doğruluk kontrolü makalesi).

ClaimAuthor

İddia sahibi hakkında bilgiler.

Alanlar
name

string

İddiayı belirten kişi veya kuruluş. Örneğin, "Ahmet Demir".
, ClaimReview.itemReviewed.author.name değerine karşılık gelir.
job_title

string

ClaimReview.itemReviewed.author.jobTitle ile eşleşir.
image_url

string

ClaimReview.itemReviewed.author.image ile eşleşir.
same_as

string

ClaimReview.itemReviewed.author.sameAs ile eşleşir.

ClaimRating

Hak talebi derecelendirmesi hakkında bilgi.

Alanlar
textual_rating

string

Kullanıcıların okuyabileceği kısa bir sözcük veya kelime öbeği olarak doğruluk puanı.
, ClaimReview.reviewRating.alternateName değerine karşılık gelir.
rating_value

Int32Value

Bu iddianın, worstRating - bestRating aralığındaki (bu değerler dahil) sayısal puanı.
, ClaimReview.reviewRating.ratingValue değerine karşılık gelir.
worst_rating

Int32Value

Sayısal değerlendirmeler için en kötü değerden en iyiye doğru ölçekteki mümkün olan en kötü değer.
, ClaimReview.reviewRating.worstRating değerine karşılık gelir.
best_rating

Int32Value

Sayısal puanlar için en kötü değerden en iyiye doğru ölçekteki mümkün olan en iyi değer.
, ClaimReview.reviewRating.bestRating değerine karşılık gelir.
rating_explanation

string

ClaimReview.reviewRating.ratingExplanation ile eşleşir.
image_url

string

ClaimReview.reviewRating.image ile eşleşir.

ClaimReview

Hak talebi incelemesi hakkında bilgi

Alanlar
publisher

Publisher

Bu iddia incelemesinin yayıncısı.
url

string

Bu hak talebi incelemesinin URL'si.
title

string

Belirlenebiliyorsa bu hak talebi incelemesinin başlığı.
review_date

Timestamp

Hak talebinin incelendiği tarih.
textual_rating

string

Metin biçiminde derecelendirme. Örneğin, "Çoğunlukla yanlış".
language_code

string

Bu yorumun yazıldığı dil. Örneğin, "en" veya "de".

ClaimReviewAuthor

İddia incelemesinin yazarı hakkında bilgiler.

Alanlar
name

string

Doğruluk kontrolünü yayınlayan kuruluşun adı.
, ClaimReview.author.name değerine karşılık gelir.
image_url

string

ClaimReview.author.image ile eşleşir.

ClaimReviewMarkup

Tek bir ClaimReview öğesinin alanları. Alanları birlikte gruplandıran alt mesajlar hariç, bu alanların her biri https://schema.org/ClaimReview adresindeki alanlarla eşleşir. Her alan için tam eşlemeyi listeleriz.

Alanlar
url

string

Bu alan isteğe bağlıdır ve varsayılan olarak sayfa URL'si kullanılır. Bu alanı, varsayılan değeri geçersiz kılmanıza olanak tanımak için sağlıyoruz. Ancak izin verilen tek geçersiz kılma, sayfa URL'si ve isteğe bağlı bir bağlantı bağlantısıdır ("sayfa atlama").
, ClaimReview.url ile eşleşiyor
claim_reviewed

string

Değerlendirilmekte olan iddianın kısa bir özeti.
, ClaimReview.claimReviewed değerine karşılık gelir.
claim_date

string

İddianın dile getirildiği ya da kamusal söyleme girdiği tarih.
, ClaimReview.itemReviewed.datePublished değerine karşılık gelir.
claim_location

string

Bu hak talebinin yapıldığı konum.
, ClaimReview.itemReviewed.name değerine karşılık gelir.
claim_first_appearance

string

Bu iddianın ilk olarak içinde göründüğü bir çalışmanın bağlantısı.
, ClaimReview.itemReviewed[@type=Claim].firstAppearance.url değerine karşılık gelir.
claim_appearances[]

string

claim_first_appearance içinde belirtilenin dışında, bu iddianın yer aldığı eserlerin bağlantılarının listesi.
, ClaimReview.itemReviewed[@type=Claim].appearance.url değerine karşılık gelir.
claim_author

ClaimAuthor

Bu hak talebinin yazarı hakkında bilgiler.
rating

ClaimRating

Bu iddia incelemesinin derecelendirmesi hakkında bilgi.

ClaimReviewMarkupPage

Bir web sayfası için bir veya daha fazla ClaimReview işaretlemesi örneği içerir.

Alanlar
name

string

Bu ClaimReview işaretleme sayfası kaynağının adı, pages/{page_id} biçiminde. Güncelleme istekleri hariç olmak üzere bu alan yalnızca çıkış içindir ve kullanıcı tarafından ayarlanmamalıdır.
page_url

string

Bu ClaimReview işaretlemesiyle ilişkili sayfanın URL'si. Her bir ClaimReview öğesinin kendi URL alanı olsa da anlamsal olarak bu bir sayfa düzeyinde alandır ve tek tek geçersiz kılınmadığı sürece bu sayfadaki her ClaimReview öğesi bu değeri kullanır.
, ClaimReview.url ile eşleşiyor
publish_date

string

Doğruluk kontrolünün yayınlandığı tarih. URL'ye benzer şekilde, anlamsal olarak bu bir sayfa düzeyinde alandır ve bu sayfadaki her ClaimReview aynı değeri içerir.
, ClaimReview.datePublished ile eşleşiyor
claim_review_author

ClaimReviewAuthor

Bu iddia incelemesinin yazarı hakkında bilgiler. Yukarıdakine benzer şekilde, bunlar anlamsal olarak sayfa düzeyinde alanlardır ve bu sayfadaki her ClaimReview aynı değerleri içerir.
claim_review_markups[]

ClaimReviewMarkup

Bu sayfayla ilgili tek tek hak talebi incelemelerinin listesi. Listedeki her öğe bir ClaimReview öğesine karşılık gelir.
version_id

string

Bu işaretlemenin sürüm kimliği. Güncelleme istekleri hariç olmak üzere bu alan yalnızca çıkış içindir ve kullanıcı tarafından ayarlanmamalıdır.

CreateClaimReviewMarkupPageRequest

Bir sayfada ClaimReview işaretlemesi oluşturma isteği.

Alanlar
claim_review_markup_page

ClaimReviewMarkupPage

Bu sayfa için oluşturulacak ClaimReview işaretlemesi. Sağlanan sayfa URL'sinin daha standart bir sürümü varsa bunun yerine onu kullanırız.

DeleteClaimReviewMarkupPageRequest

Bir sayfadaki tüm ClaimReview işaretlemelerinin silinmesi isteği.

Alanlar
name

string

Silinecek kaynağın adı (pages/{page_id} biçiminde).

FactCheckedClaimImageSearchRequest

Doğruluk kontrolü yapılmış iddiaları resimle arama isteği.

Alanlar
image_uri

string

Zorunlu. Kaynak resmin URI'si. Bu, herkese açık bir resim HTTP/HTTPS URL'si olmalıdır.

Google, HTTP/HTTPS URL'lerinden resim getirirken isteğin tamamlanacağını garanti edemez. Belirtilen ana makine isteği reddederse (ör. istek sınırlama veya DOS önleme nedeniyle) ya da Google, kötüye kullanımı önlemek için siteye yönelik istekleri sınırlarsa isteğiniz başarısız olabilir. Üretim uygulamaları için harici olarak barındırılan resimleri kullanmamalısınız.
language_code

string

İsteğe bağlıdır. BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Şu anda bölgeyi dikkate almasak da sonuçları dile göre kısıtlamak için kullanılabilir.
page_size

int32

İsteğe bağlıdır. Sayfalara ayırma boyutu. Bu sayıya kadar sonuç döndürürüz. Ayarlanmamışsa varsayılan değeri 10'dur.
page_token

string

İsteğe bağlıdır. Sayfalara ayırma jetonu. Bir önceki Liste isteğinden döndürülen next_page_token varsa sonraki sayfayı almak için bunu sağlayabilirsiniz. Diğer tüm alanlar, önceki istekteki değerlerle aynı olmalıdır.
offset

int32

İsteğe bağlıdır. Arama sonuçlarındaki geçerli uzaklığı (yani başlangıç sonuç konumu) belirten bir tam sayı. Bu alan yalnızca page_token ayarlanmamışsa dikkate alınır. Örneğin, 0, eşleşen ilk sonuçtan itibaren sonuç döndürülmesi, 10 ise 11. sonuçtan itibaren sonuç döndürülmesi anlamına gelir.

FactCheckedClaimImageSearchResponse

Doğruluk kontrolü yapılmış iddiaları resimle arama sonucunda alınan yanıt.

Alanlar
results[]

Result

Hak taleplerinin listesi ve bunlarla ilişkili tüm bilgiler.
next_page_token

string

Arama yanıtındaki sonraki sayfalama jetonu. Aşağıdaki istek için page_token olarak kullanılmalıdır. Boş değer, başka sonuç olmadığını gösterir.

Sonuç

Bir hak talebi ve ilişkili bilgileri.

Alanlar
claim

Claim

Sorguyla eşleşen bir hak talebi.

FactCheckedClaimSearchRequest

Doğruluğu kontrol edilmiş iddialar arasında arama yapma isteği.

Alanlar
query

string

Metin sorgusu dizesi. review_publisher_site_filter belirtilmediği sürece zorunludur.
language_code

string

BCP-47 dil kodu (ör. "en-US" veya "sr-Latn"). Şu anda bölgeyi dikkate almasak da sonuçları dile göre kısıtlamak için kullanılabilir.
review_publisher_site_filter

string

Sonuçları filtrelemek için yorum yayıncı sitesi (ör. nytimes.com).
max_age_days

int32

Döndürülen arama sonuçlarının maksimum yaşı (gün cinsinden). Yaş, talep tarihi veya yorum tarihi (hangisi daha yeniyse) ile belirlenir.
page_size

int32

Sayfalara ayırma boyutu. Bu sayıya kadar sonuç döndürürüz. Ayarlanmamışsa varsayılan değeri 10'dur.
page_token

string

Sayfalara ayırma jetonu. Bir önceki Liste isteğinden döndürülen next_page_token varsa sonraki sayfayı almak için bunu sağlayabilirsiniz. Diğer tüm alanlar, önceki istekteki değerlerle aynı olmalıdır.
offset

int32

Arama sonuçlarındaki geçerli uzaklığı (yani başlangıç sonuç konumu) belirten bir tam sayı. Bu alan yalnızca page_token ayarlanmamışsa dikkate alınır. Örneğin, 0, eşleşen ilk sonuçtan itibaren sonuç döndürülmesi, 10 ise 11. sonuçtan itibaren sonuç döndürülmesi anlamına gelir.

FactCheckedClaimSearchResponse

Doğruluğu kontrol edilmiş iddialar arandığında verilen yanıt.

Alanlar
claims[]

Claim

Hak taleplerinin listesi ve bunlarla ilişkili tüm bilgiler.
next_page_token

string

Arama yanıtındaki sonraki sayfalama jetonu. Aşağıdaki istek için page_token olarak kullanılmalıdır. Boş değer, başka sonuç olmadığını gösterir.

GetClaimReviewMarkupPageRequest

Bir sayfada ClaimReview işaretlemesini alma isteği.

Alanlar
name

string

Alınacak kaynağın adı (pages/{page_id} biçiminde).

ListClaimReviewMarkupPagesRequest

ClaimReview işaretlemesi için istek.

Alanlar
url

string

ClaimReview biçimlendirmesinin alınacağı URL. En fazla bir sonuç gösterilir. Biçimlendirme, sağlanan URL'nin daha standart bir sürümüyle ilişkilendirilmişse bunun yerine bu URL'yi döndürürüz. Kuruluşla birlikte belirtilemez.
organization

string

Biçimlendirmelerin getirilmesini istediğimiz kuruluş. Örneğin, "site.com". URL ile birlikte belirtilemez.
page_size

int32

Sayfalara ayırma boyutu. Bu sayıya kadar sonuç döndürürüz. Ayarlanmamışsa varsayılan değeri 10'dur. Bir URL istendiğinde etkisi olmaz.
page_token

string

Sayfalara ayırma jetonu. Bir önceki Liste isteğinden döndürülen next_page_token varsa sonraki sayfayı almak için bunu sağlayabilirsiniz. Diğer tüm alanlar, önceki istekteki değerlerle aynı olmalıdır.
offset

int32

Arama sonuçlarındaki geçerli uzaklığı (yani başlangıç sonuç konumu) belirten bir tam sayı. Bu alan yalnızca page_token ayarlanmamışsa ve istek belirli bir URL için değilse dikkate alınır. Örneğin, 0, eşleşen ilk sonuçtan itibaren sonuç döndürülmesi, 10 ise 11. sonuçtan itibaren sonuç döndürülmesi anlamına gelir.

ListClaimReviewMarkupPagesResponse

ClaimReview işaretlemesinden gelen yanıt.

Alanlar
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview işaretlemesi içeren sayfaların sonuç listesi.
next_page_token

string

Arama yanıtındaki sonraki sayfalama jetonu. Aşağıdaki istek için page_token olarak kullanılmalıdır. Boş değer, başka sonuç olmadığını gösterir.

Yayıncı

Yayıncı hakkında bilgiler.

Alanlar
name

string

Bu yayıncının adı. Örneğin, "Awesome Fact Checks" (Harika Doğruluk Kontrolleri).
site

string

Protokol veya "www" öneki olmadan, ana makine düzeyinde site adı. Örneğin, "awesomefactchecks.com". Bu alanın değeri tamamen hak talebi inceleme URL'sine dayanır.

UpdateClaimReviewMarkupPageRequest

Bir sayfadaki tüm ClaimReview işaretlemelerinin güncellenmesini isteme

Alanlar
claim_review_markup_page

ClaimReviewMarkupPage

Bu sayfanın güncellenmiş ClaimReview işaretlemesi. Güncelleme isteklerinde, güncellenecek kaynağın hem kaynak adı hem de sürüm kimliği belirtilmelidir. Belirtilen sürüm kimliği, en son biçimlendirmenin sürüm kimliğiyle eşleşmezse (bu durum, biçimlendirme son okunmasından bu yana değiştirilmişse oluşabilir) bu istek başarısız olur. Güncellemeler sayfa URL'sini de değiştirmemelidir. İşaretlemenin URL'sini değiştirmek için eski işaretlemeyi silip yeni URL ile yeniden oluşturun.