Package google.factchecking.factchecktools.v1alpha1

Indeks

FactCheckToolsService

Fact Check Tools API

Interfejs Fact Check Tools API zapewnia programowy dostęp do funkcji dostępnych w interfejsie narzędzi do weryfikowania informacji Google na stronie https://g.co/factchecktools.

Obecnie dostępne interfejsy API to:

  • Wyszukiwanie zweryfikowanych twierdzeń (dostępne w interfejsie Eksploratora informacji zweryfikowanych).
  • Wyszukiwanie zweryfikowanych twierdzeń na podstawie obrazu (dostępne w interfejsie Eksploratora informacji zweryfikowanych).

  • Interfejs CRUD dla ClaimReview na stronie (udostępniany przez interfejs narzędzia do oznaczania informacji zweryfikowanych).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Utwórz na stronie znacznik ClaimReview.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Usuń wszystkie znaczniki ClaimReview na stronie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Wyszukiwanie zweryfikowanych twierdzeń za pomocą obrazu jako zapytania.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Przeszukuj zweryfikowane twierdzenia.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Pobierz wszystkie znaczniki ClaimReview na stronie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Wyświetl strony z oznaczeniami ClaimReview dla określonego adresu URL lub organizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Aktualizacja wszystkich znaczników ClaimReview na stronie

Pamiętaj, że jest to pełna aktualizacja. Aby zachować istniejący kod ClaimReview na stronie, najpierw wykonaj operację Get, a potem zmodyfikuj zwrócony kod i wywołaj operację Update, podając cały kod ClaimReview w treści.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Roszczenie

Informacje o roszczeniu.

Pola
text

string

Tekst roszczenia. Na przykład „W ciągu ostatnich 2 lat przestępczość wzrosła dwukrotnie”.
claimant

string

Osoba lub organizacja zgłaszająca roszczenie. Na przykład „Jan Kowalski”.
claim_date

Timestamp

Data zgłoszenia roszczenia.
claim_review[]

ClaimReview

Co najmniej 1 opinia na temat tego stwierdzenia (czyli artykuł z weryfikacją faktów).

ClaimAuthor

Informacje o autorze twierdzenia.

Pola
name

string

Osoba lub organizacja zgłaszająca roszczenie. Na przykład „Jan Kowalski”.
Odpowiada ClaimReview.itemReviewed.author.name.
job_title

string

Odpowiada ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Odpowiada ClaimReview.itemReviewed.author.image.
same_as

string

Odpowiada ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informacje o ocenie roszczenia.

Pola
textual_rating

string

Ocena prawdziwości w formie krótkiego, czytelnego dla użytkownika słowa lub wyrażenia.
Odpowiada ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Ocena numeryczna twierdzenia w skali od worstRating do bestRating włącznie.
Odpowiada ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

W przypadku ocen numerycznych jest to najniższa możliwa wartość, gdy skala ocen ma charakter rosnący, czyli od najgorszej (najniższej) do najlepszej (najwyższej).
Odpowiada ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

W przypadku ocen numerycznych jest to najwyższa możliwa wartość, gdy skala ocen ma charakter rosnący, czyli od najgorszej (najniższej) do najlepszej (najwyższej).
Odpowiada ClaimReview.reviewRating.bestRating.
rating_explanation

string

Odpowiada ClaimReview.reviewRating.ratingExplanation.
image_url

string

Odpowiada ClaimReview.reviewRating.image.

ClaimReview

Informacje o sprawdzeniu roszczenia.

Pola
publisher

Publisher

Wydawca tej weryfikacji informacji.
url

string

Adres URL tej weryfikacji roszczenia.
title

string

Tytuł tej recenzji roszczenia, jeśli można go ustalić.
review_date

Timestamp

Data sprawdzenia roszczenia.
textual_rating

string

Ocena tekstowa. Na przykład „W większości fałszywe”.
language_code

string

Język, w którym napisano tę opinię. np. „en” lub „de”.

ClaimReviewAuthor

Informacje o autorze weryfikacji roszczenia.

Pola
name

string

Nazwa organizacji publikującej informacje zweryfikowane.
Odpowiada ClaimReview.author.name.
image_url

string

Odpowiada ClaimReview.author.image.

ClaimReviewMarkup

Pola pojedynczego elementu ClaimReview. Z wyjątkiem podrzędnych wiadomości, które grupują pola, każde z tych pól odpowiada polom w https://schema.org/ClaimReview. Podajemy dokładne mapowanie każdego pola.

Pola
url

string

To pole jest opcjonalne. Domyślnie zawiera adres URL strony. Udostępniamy to pole, aby umożliwić Ci zastąpienie wartości domyślnej, ale jedynym dozwolonym zastąpieniem jest adres URL strony plus opcjonalny link do kotwicy („skok strony”).
Odpowiada ClaimReview.url
claim_reviewed

string

Krótkie podsumowanie ocenianego twierdzenia.
Odpowiada ClaimReview.claimReviewed.
claim_date

string

Data wygłoszenia twierdzenia lub pojawienia się go w dyskursie publicznym.
Odpowiada ClaimReview.itemReviewed.datePublished.
claim_location

string

Lokalizacja, w której zgłoszono to roszczenie.
Odpowiada ClaimReview.itemReviewed.name.
claim_first_appearance

string

Link do utworu, w którym po raz pierwszy pojawia się to twierdzenie.
Odpowiada ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Lista linków do prac, w których pojawia się to twierdzenie (oprócz tego, które zostało podane w claim_first_appearance).
Odpowiada ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Informacje o autorze tego roszczenia.
rating

ClaimRating

Informacje o ocenie tej weryfikacji twierdzenia.

ClaimReviewMarkupPage

Zawiera co najmniej 1 instancję kodu ClaimReview na stronie.

Pola
name

string

Nazwa tego zasobu strony ze znacznikami ClaimReview w formacie pages/{page_id}. Z wyjątkiem żądań aktualizacji to pole jest tylko polem wyjściowym i nie powinno być ustawiane przez użytkownika.
page_url

string

Adres URL strony powiązanej z tym znacznikiem ClaimReview. Każdy element ClaimReview ma własne pole adresu URL, ale semantycznie jest to pole na poziomie strony i każdy element ClaimReview na tej stronie będzie używać tej wartości, chyba że zostanie ona indywidualnie zastąpiona.
Odpowiada ClaimReview.url
publish_date

string

Data opublikowania informacji zweryfikowanych. Podobnie jak w przypadku adresu URL, jest to pole na poziomie strony, a każdy element ClaimReview na tej stronie będzie zawierać tę samą wartość.
Odpowiada ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Informacje o autorze tej weryfikacji. Podobnie jak powyżej, semantycznie są to pola na poziomie strony, a każdy element ClaimReview na tej stronie będzie zawierać te same wartości.
claim_review_markups[]

ClaimReviewMarkup

Lista opinii na temat pojedynczych twierdzeń dotyczących tej strony. Każdy element na liście odpowiada jednemu elementowi ClaimReview.
version_id

string

Identyfikator wersji tego kodu. Z wyjątkiem żądań aktualizacji to pole jest tylko polem wyjściowym i nie powinno być ustawiane przez użytkownika.

CreateClaimReviewMarkupPageRequest

Prośba o utworzenie na stronie kodu ClaimReview.

Pola
claim_review_markup_page

ClaimReviewMarkupPage

Znacznik ClaimReview, który należy utworzyć dla tej strony. Jeśli podasz bardziej kanoniczną wersję adresu URL strony, użyjemy jej zamiast tej podanej w zapytaniu.

DeleteClaimReviewMarkupPageRequest

Prośba o usunięcie wszystkich znaczników ClaimReview na stronie.

Pola
name

string

Nazwa zasobu do usunięcia w formacie pages/{page_id}.

FactCheckedClaimImageSearchRequest

Prośba o wyszukiwanie zweryfikowanych twierdzeń według obrazu.

Pola
image_uri

string

Wymagany. Identyfikator URI obrazu źródłowego. Musi to być publicznie dostępny adres URL HTTP/HTTPS obrazu.

Podczas pobierania obrazów z adresów URL HTTP/HTTPS Google nie może zagwarantować, że żądanie zostanie zrealizowane. Twoje żądanie może się nie powieść, jeśli określony host je odrzuci (np. z powodu ograniczenia liczby żądań lub zapobiegania atakom typu DoS) albo jeśli Google ograniczy liczbę żądań do witryny, aby zapobiec nadużyciom. W przypadku aplikacji produkcyjnych nie należy polegać na obrazach hostowanych zewnętrznie.
language_code

string

Opcjonalnie. Kod języka w formacie BCP-47, np. „en-US” lub „sr-Latn”. Może służyć do ograniczania wyników według języka, ale obecnie nie uwzględniamy regionu.
page_size

int32

Opcjonalnie. Rozmiar podziału na strony. Zwrócimy maksymalnie tyle wyników. Jeśli nie zostanie ustawiony, domyślna wartość to 10.
page_token

string

Opcjonalnie. Token podziału na strony. Aby uzyskać następną stronę, możesz podać wartość next_page_token zwróconą przez poprzednią prośbę List (jeśli taka istnieje). Wszystkie pozostałe pola muszą mieć takie same wartości jak w poprzednim żądaniu.
offset

int32

Opcjonalnie. Liczba całkowita określająca bieżące przesunięcie (czyli lokalizację początkową wyniku) w wynikach wyszukiwania. To pole jest brane pod uwagę tylko wtedy, gdy pole page_token nie jest skonfigurowane. Na przykład 0 oznacza, że wyniki mają być zwracane od pierwszego pasującego wyniku, a 10 – od 11 wyniku.

FactCheckedClaimImageSearchResponse

Odpowiedź na wyszukiwanie zweryfikowanych twierdzeń na podstawie obrazu.

Pola
results[]

Result

Lista roszczeń i wszystkie powiązane z nimi informacje.
next_page_token

string

Następny token podziału na strony w odpowiedzi wyszukiwania. Powinien on być użyty jako page_token w tym żądaniu. Pusta wartość oznacza brak dalszych wyników.

Wynik

roszczenie i powiązane z nim informacje;

Pola
claim

Claim

Roszczenie, które pasuje do zapytania.

FactCheckedClaimSearchRequest

Prośba o wyszukanie zweryfikowanych twierdzeń.

Pola
query

string

Tekstowy ciąg zapytania. Wymagane, chyba że określono review_publisher_site_filter.
language_code

string

Kod języka w formacie BCP-47, np. „en-US” lub „sr-Latn”. Może służyć do ograniczania wyników według języka, ale obecnie nie uwzględniamy regionu.
review_publisher_site_filter

string

Witryna wydawcy opinii, według której chcesz filtrować wyniki, np. nytimes.com.
max_age_days

int32

Maksymalny wiek zwróconych wyników wyszukiwania (w dniach). Wiek jest określany na podstawie daty roszczenia lub daty weryfikacji, w zależności od tego, która z nich jest późniejsza.
page_size

int32

Rozmiar podziału na strony. Zwrócimy maksymalnie tyle wyników. Jeśli nie zostanie ustawiony, domyślna wartość to 10.
page_token

string

Token podziału na strony. Aby uzyskać następną stronę, możesz podać wartość next_page_token zwróconą przez poprzednią prośbę List (jeśli taka istnieje). Wszystkie pozostałe pola muszą mieć takie same wartości jak w poprzednim żądaniu.
offset

int32

Liczba całkowita określająca bieżące przesunięcie (czyli lokalizację początkową wyniku) w wynikach wyszukiwania. To pole jest brane pod uwagę tylko wtedy, gdy pole page_token nie jest skonfigurowane. Na przykład 0 oznacza, że wyniki mają być zwracane od pierwszego pasującego wyniku, a 10 – od 11 wyniku.

FactCheckedClaimSearchResponse

Odpowiedź na wyszukiwanie zweryfikowanych twierdzeń.

Pola
claims[]

Claim

Lista roszczeń i wszystkie powiązane z nimi informacje.
next_page_token

string

Następny token podziału na strony w odpowiedzi wyszukiwania. Powinien on być użyty jako page_token w tym żądaniu. Pusta wartość oznacza brak dalszych wyników.

GetClaimReviewMarkupPageRequest

Prośba o pobranie kodu ClaimReview na stronie.

Pola
name

string

Nazwa zasobu do pobrania w formacie pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Prośba o oznaczenie ClaimReview.

Pola
url

string

Adres URL, z którego mają być pobierane znaczniki ClaimReview. Wyświetli się co najwyżej 1 wynik. Jeśli znacznik jest powiązany z bardziej kanoniczną wersją podanego adresu URL, zwrócimy ten adres URL. Nie można go określić razem z organizacją.
organization

string

Organizacja, dla której chcemy pobrać znaczniki. Na przykład „site.com”. Nie można go określić razem z adresem URL.
page_size

int32

Rozmiar podziału na strony. Zwrócimy maksymalnie tyle wyników. Jeśli nie zostanie ustawiony, domyślna wartość to 10. Nie ma wpływu na żądanie adresu URL.
page_token

string

Token podziału na strony. Aby uzyskać następną stronę, możesz podać wartość next_page_token zwróconą przez poprzednią prośbę List (jeśli taka istnieje). Wszystkie pozostałe pola muszą mieć takie same wartości jak w poprzednim żądaniu.
offset

int32

Liczba całkowita określająca bieżące przesunięcie (czyli lokalizację początkową wyniku) w wynikach wyszukiwania. To pole jest brane pod uwagę tylko wtedy, gdy pole page_token nie jest ustawione i gdy żądanie nie dotyczy konkretnego adresu URL. Na przykład 0 oznacza, że wyniki mają być zwracane od pierwszego pasującego wyniku, a 10 – od 11 wyniku.

ListClaimReviewMarkupPagesResponse

Odpowiedź z oznaczenia ClaimReview wizytówki.

Pola
claim_review_markup_pages[]

ClaimReviewMarkupPage

Lista wyników stron ze znacznikami ClaimReview.
next_page_token

string

Następny token podziału na strony w odpowiedzi wyszukiwania. Powinien on być użyty jako page_token w tym żądaniu. Pusta wartość oznacza brak dalszych wyników.

Wydawca

Informacje o wydawcy.

Pola
name

string

Nazwa wydawcy. Na przykład „Awesome Fact Checks”.
site

string

Nazwa witryny na poziomie hosta bez protokołu i przedrostka „www”. Na przykład „awesomefactchecks.com”. Wartość tego pola jest obliczana wyłącznie na podstawie adresu URL weryfikacji roszczenia.

UpdateClaimReviewMarkupPageRequest

Prośba o zaktualizowanie wszystkich tagów ClaimReview na stronie.

Pola
claim_review_markup_page

ClaimReviewMarkupPage

Zaktualizowane znaczniki ClaimReview na tej stronie. W przypadku żądań aktualizacji musisz podać zarówno nazwę zasobu, jak i identyfikator wersji zasobu do zaktualizowania. Jeśli podany identyfikator wersji nie pasuje do identyfikatora wersji najnowszego kodu (co może się zdarzyć, jeśli kod został zmodyfikowany od czasu ostatniego odczytu), to żądanie zakończy się niepowodzeniem. Aktualizacje nie mogą też zmieniać adresu URL strony. Aby zmienić adres URL kodu, usuń stary kod i utwórz go ponownie z nowym adresem URL.