Package google.factchecking.factchecktools.v1alpha1

Dizin

Doğruluk Kontrol Araçları Hizmeti

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

Doğruluk Kontrolü Araçları API'si, https://g.co/factchecktools adresinde bulunan Google Doğruluk Kontrol Araçları ön ucu aracılığıyla sağlanan işlevlere programatik erişim sağlar.

Mevcut API'ler şunlardır:

  • Doğruluk Kontrollü Hak Talebi Araması (Doğruluk Kontrolü Gezgini ön ucu aracılığıyla sağlanır).

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

CreateClaimReviewMarkup Sayfası

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/userinfo.email
ClaimReviewMarkupPage'i sil

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Bir sayfadaki tüm ClaimReview işaretlemesini silin.

Yetkilendirme Kapsamları

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

  • https://www.googleapis.com/auth/userinfo.email
Doğruluk Kontrollü Hak Talebi Araması

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Doğruluk kontrollerinden gelen iddialarda arama yapın.

GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

ClaimReview işaretlemesinin tamamını bir sayfaya alın.

Yetkilendirme Kapsamları

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

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Belirli bir URL’ye veya kuruluşa ilişkin ClaimReview işaretleme sayfalarını listeleyin.

Yetkilendirme Kapsamları

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

  • https://www.googleapis.com/auth/userinfo.email
UpdateReviewMarkupPage Güncelleme

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

Bunun tam kapsamlı bir güncelleme olduğunu unutmayın. Bir sayfadaki mevcut ClaimReview işaretlemesini korumak için önce bir Alma işlemi yapın, sonra döndürülen işaretlemeyi değiştirin ve son olarak gövde olarak ClaimReview işaretlemesinin tamamını kullanarak Güncelleme'yi çağırın.

Yetkilendirme Kapsamları

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

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

İddia

Hak talebiyle ilgili bilgiler.

Alanlar
text

string

Hak talebi metni. Örneğin, "Suç "Son 2 yılda ikiye katlandı".

claimant

string

İddiayı belirten bir kişi veya kuruluş. Örneğin, "Cem Yılmaz".

claim_date

Timestamp

Hak talebinin yapıldığı tarihtir.

claim_review[]

ClaimReview

Bu iddiayla ilgili bir veya daha fazla yorum (yani doğruluk kontrolü makalesi).

ClaimAuthor

Hak talebinde bulunan kullanıcıyla ilgili bilgi.

Alanlar
name

string

İddiayı belirten bir kişi veya kuruluş. Örneğin, "Cem Yılmaz".
ClaimReview.itemReviewed.author.name etiketine karşılık gelir.

job_title

string

Karşılık gelen ClaimReview.itemReviewed.author.jobTitle.

image_url

string

Karşılık gelen ClaimReview.itemReviewed.author.image.

same_as

string

Karşılık gelen ClaimReview.itemReviewed.author.sameAs.

Hak Talebi Derecelendirmesi

Hak talebi puanıyla ilgili bilgiler.

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 etiketine karşılık gelir.

rating_value

Int32Value

Bu iddianın worstRating (en İyi Puan dahil) aralığındaki sayısal puanı.
ClaimReview.reviewRating.ratingValue etiketine karşılık gelir.

worst_rating

Int32Value

Sayısal puanlar 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 etiketine 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 etiketine karşılık gelir.

rating_explanation

string

Karşılık gelen ClaimReview.reviewRating.ratingExplanation.

image_url

string

Karşılık gelen ClaimReview.reviewRating.image.

ClaimReview

İddia incelemesi hakkında bilgi.

Alanlar
publisher

Publisher

Bu iddia incelemesinin yayıncısı.

url

string

Bu iddia incelemesinin URL'si.

title

string

Tespit edilebileceği durumlarda bu iddia incelemesinin başlığı.

review_date

Timestamp

Hak talebinin incelendiği tarihtir.

textual_rating

string

Metin derecelendirmesi. Örneğin, "Çoğunlukla yanlış".

language_code

string

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

ClaimReviewAuthor

İddia inceleme yazarıyla ilgili bilgiler.

Alanlar
name

string

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

image_url

string

Karşılık gelen ClaimReview.author.image.

ClaimReviewİşaretleme

Tek bir ClaimReview öğesi için alanlar. Alanları birlikte gruplandıran alt mesajlar hariç bu alanların her biri https://schema.org/ClaimReview adresindeki alanlara karşılık gelir. Her alan için tam eşleme listelenir.

Alanlar
url

string

Bu alan isteğe bağlıdır ve varsayılan olarak sayfa URL'sine ayarlanır. Bu alanı, varsayılan değeri geçersiz kılmanıza olanak tanırken geçersiz kılmaya izin vermemiz için sayfa URL'sinin yanı sıra isteğe bağlı bir bağlantı bağlantısı ("sayfa atlama"dır) verilebilir.
Şuna karşılık gelir: ClaimReview.url

claim_reviewed

string

Değerlendirilmekte olan iddianın kısa bir özeti.
ClaimReview.claimReviewed etiketine karşılık gelir.

claim_date

string

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

claim_location

string

Bu iddianın yapıldığı konum.
ClaimReview.itemReviewed.name etiketine karşılık gelir.

claim_first_appearance

string

Bu iddianın ilk olarak gösterildiği bir çalışmanın bağlantısı.
ClaimReview.itemReviewed[@type=Claim].firstAppearance.url etiketine karşılık gelir.

claim_appearances[]

string

Bu iddianın, claim_first_appearance bölümünde belirtilenlerden farklı şekilde kullanıldığı çalışmaların listesi.
ClaimReview.itemReviewed[@type=Claim].appearance.url etiketine karşılık gelir.

claim_author

ClaimAuthor

Bu iddianın yazarıyla ilgili bilgiler.

rating

ClaimRating

Bu iddia incelemesinin puanı hakkında bilgi.

ClaimReviewMarkupSayfası

Bir web sayfası için bir veya daha fazla ClaimReview işaretleme örneğini barındırır.

Alanlar
name

string

Bu ClaimReview işaretleme sayfası kaynağının adı (pages/{page_id} biçiminde). Bu alan, güncelleme istekleri dışında yalnızca çıkışa yöneliktir ve kullanıcı tarafından ayarlanmamalıdır.

page_url

string

Bu ClaimReview işaretlemesiyle ilişkili sayfanın URL'si. Her ClaimReview kendi URL alanına sahiptir, ancak semantik olarak bu sayfa düzeyinde bir alandır ve bu sayfadaki her ClaimReview, tek tek geçersiz kılınmadığı sürece bu değeri kullanır.
Şuna karşılık gelir: ClaimReview.url

publish_date

string

Doğruluk kontrolünün yayınlandığı tarih. URL'ye benzer şekilde, semantik olarak bu sayfa düzeyinde bir alandır ve bu sayfadaki her ClaimReview aynı değeri içerir.
Şuna karşılık gelir: ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Bu iddia incelemesinin yazarıyla ilgili bilgiler. Yukarıdakine benzer şekilde, bunlar semantik olarak sayfa düzeyinde alanlardır ve bu sayfadaki her ClaimReview aynı değerleri içerir.

claim_review_markups[]

ClaimReviewMarkup

Bu sayfa için ayrı ayrı 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. Bu alan, güncelleme istekleri dışında yalnızca çıkışa yöneliktir 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 bunu kullanırız.

ClaimReviewMarkupPageRequest'i sil

Bir sayfadaki ClaimReview işaretlemesinin tamamını silme isteği.

Alanlar
name

string

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

Doğruluk KontrollüTalepTalepİ

Doğruluk kontrollü hak talepleri aracılığıyla arama isteği.

Alanlar
query

string

Metinli sorgu dizesi. review_publisher_site_filter belirtilmediği sürece gereklidir.

language_code

string

BCP-47 dil kodu (ör. &en; ABD-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ın filtreleneceği inceleme yayıncısı sitesi (ör. nytimes.com).

max_age_days

int32

Döndürülen arama sonuçlarının gün cinsinden maksimum yaşı. Yaş, hak talebi tarihine veya inceleme tarihine (hangisi daha yeniyse) göre belirlenir.

page_size

int32

Sayfalara ayırma boyutu. Bu kadar çok sonuç döndürürüz. Ayarlanmazsa varsayılan olarak 10 değerine ayarlanır.

page_token

string

Sayfalara ayırma jetonu. Önceki sayfayı almak için önceki liste isteğinden döndürülen next_page_token sağlayabilirsiniz. Böylece sonraki sayfaya ulaşabilirsiniz. Diğer tüm alanların önceki istektekilerle aynı değerlere sahip olması gerekir.

offset

int32

Arama sonuçlarındaki geçerli ofseti (yani sonuçların konumunu) belirten bir tam sayı. Bu alan yalnızca page_token ayarlanmadan bırakılırsa dikkate alınır. Örneğin 0, ilk eşleşen sonuçtan başlayarak sonuçların döndürülmesi, 10, 11. sonuçtan döndürülmesi anlamına gelir.

Doğrulanmış KontrolArama İsteği yanıtı

Doğruluk kontrol edilen iddialarda arama yapma.

Alanlar
claims[]

Claim

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

next_page_token

string

Arama yanıtında sonraki sayfalara ayırma 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şaretlemesinin istenmesi.

Alanlar
name

string

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

ListClaimReviewMarkupPagesRequest

ClaimReview işaretlemesi listeleme isteği.

Alanlar
url

string

ClaimReview işaretlemesinin alınacağı URL. En fazla bir sonuç olacaktır. İşaretleme, sağlanan URL'nin daha standart bir sürümüyle ilişkilendirilmişse, söz konusu URL'yi döndürürüz. Bir kuruluşla birlikte belirtilemez.

organization

string

İşaretlemelerini almak istediğimiz kuruluş. Örneğin, "site.com". URL ile birlikte belirtilemez.

page_size

int32

Sayfalara ayırma boyutu. Bu kadar çok sonuç döndürürüz. Ayarlanmazsa varsayılan olarak 10 değerine ayarlanır. URL istendiğinde herhangi bir etkisi olmaz.

page_token

string

Sayfalara ayırma jetonu. Önceki sayfayı almak için önceki liste isteğinden döndürülen next_page_token sağlayabilirsiniz. Böylece sonraki sayfaya ulaşabilirsiniz. Diğer tüm alanların önceki istektekilerle aynı değerlere sahip olması gerekir.

offset

int32

Arama sonuçlarındaki geçerli ofseti (yani sonuçların konumunu) belirten bir tam sayı. Bu alan yalnızca page_token ayarlanmadan bırakılırsa ve istek belirli bir URL ile ilgili değilse dikkate alınır. Örneğin 0, ilk eşleşen sonuçtan başlayarak sonuçların döndürülmesi, 10, 11. sonuçtan döndürülmesi anlamına gelir.

ListClaimReviewMarkupPagesResponse

ClaimReview işaretlemesinin yanıtı.

Alanlar
claim_review_markup_pages[]

ClaimReviewMarkupPage

ClaimReview işaretlemesinin sonuç listesi.

next_page_token

string

Arama yanıtında sonraki sayfalara ayırma 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 bilgi.

Alanlar
name

string

Bu yayıncının adı. Örneğin, "Etkileyici Doğruluk Kontrolleri".

site

string

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

UpdateClaimMarkupPageRequest'i güncelle

Bir sayfadaki ClaimReview işaretlemenin tamamını güncelleme isteği.

Alanlar
claim_review_markup_page

ClaimReviewMarkupPage

Bu sayfa için ClaimReview işaretlemesi güncellendi. Güncelleme istekleri, güncellenecek kaynağın hem kaynak adını hem de sürüm kimliğini belirtmelidir. Belirtilen sürüm kimliği en son işaretlemenin sürüm kimliğiyle eşleşmiyorsa (son okumadan sonra işaretleme değiştirilmişse gerçekleşebilir) 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 silin ve yeni URL ile yeniden oluşturun.