Package google.factchecking.factchecktools.v1alpha1

Indeks

Usługa informacji zweryfikowanych

Interfejs API informacji zweryfikowanych

Interfejs Fact Check Tools API umożliwia automatyczny dostęp do funkcji udostępnianych przez interfejs Google My Fact Check Tools (https://g.co/factchecktools).

Obecne interfejsy API to:

  • Wyszukiwanie informacji zweryfikowanych (dostępne w interfejsie Eksploratora informacji zweryfikowanych).

  • Interfejs CRUD znaczników ClaimReview na stronie (dostarczony z użyciem frontendu narzędzia do znaczników Informacji zweryfikowanych).

Utwórz znacznik opinii

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Utwórz znaczniki ClaimReview na stronie.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

  • https://www.googleapis.com/auth/userinfo.email
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/userinfo.email
Wyszukiwanie faktów

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Przeglądaj roszczenia zweryfikowane.
Strona 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/userinfo.email
Wyświetl listę ZnacznikówRecenzji

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Wymień strony z znacznikami ClaimReview dotyczące konkretnego adresu URL lub nazwy organizacji.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Zaktualizuj wszystkie znaczniki ClaimReview na stronie

Pamiętaj, że to pełna aktualizacja. Aby zachować istniejące znaczniki ClaimReview na stronie, najpierw przeprowadź operację Get, a potem zmodyfikuj zwrócone znaczniki. Na koniec wywołaj aktualizację ze wszystkimi znacznikami ClaimReview w treści.

Zakresy autoryzacji

Wymaga następującego zakresu OAuth:

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

Claim

Informacje o roszczeniu.

Pola
text

string

Treść roszczenia. Na przykład „Kryminał podwoił się w ciągu ostatnich 2 lat”.

claimant

string

Osoba lub organizacja twierdząca. Na przykład „Jan Kowalski”.

claim_date

Timestamp

Data zgłoszenia roszczenia.

claim_review[]

ClaimReview

Co najmniej 1 opinia dotycząca tego twierdzenia (tzw. artykuł z informacjami zweryfikowanymi).

ClaimAuthor

Informacje o autorze roszczenia.

Pola
name

string

Osoba lub organizacja twierdząca. Na przykład „Jan Kowalski”.
Odpowiada: ClaimReview.itemReviewed.author.name.

job_title

string

Odpowiada polu ClaimReview.itemReviewed.author.jobTitle.

image_url

string

Odpowiada polu ClaimReview.itemReviewed.author.image.

same_as

string

Odpowiada polu ClaimReview.itemReviewed.author.sameAs.

RatingClaim,

Informacje o ocenie twierdzenia.

Pola
textual_rating

string

Ocena prawdziwości w postaci zrozumiałego dla człowieka krótkiego słowa lub wyrażenia.
Odpowiada: ClaimReview.reviewRating.alternateName.

rating_value

Int32Value

Liczbowa ocena tego roszczenia mieszcząca się w zakresie najgorszej oceny — najlepsza ocena.
Odpowiada: ClaimReview.reviewRating.ratingValue.

worst_rating

Int32Value

W przypadku ocen numerycznych jest to najniższa możliwa wartość, od najgorszej (najlepszej) do najlepszej (skali).
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 polu ClaimReview.reviewRating.ratingExplanation.

image_url

string

Odpowiada polu ClaimReview.reviewRating.image.

ClaimReview

Informacje o weryfikacji twierdzenia.

Pola
publisher

Publisher

Wydawca tego twierdzenia.

url

string

Adres URL tego twierdzenia.

title

string

Tytuł opinii, jeśli można ją określić.

review_date

Timestamp

Data zgłoszenia roszczenia.

textual_rating

string

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

language_code

string

Język tej opinii. Na przykład „pl” lub „de”.

ClaimReviewAuthor

Informacje o autorze twierdzenia.

Pola
name

string

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

image_url

string

Odpowiada polu ClaimReview.author.image.

ClaimReviewMarkup

Pola dla pojedynczego elementu ClaimReview. Z wyjątkiem wiadomości podrzędnych, które grupują pola, każde z nich odpowiada polu https://schema.org/ClaimReview. Dla każdego pola podajemy dokładne mapowanie.

Pola
url

string

To pole jest opcjonalne i domyślnie przyjmuje adres URL strony. To pole umożliwia zastąpienie wartości domyślnej, ale jedynym dopuszczalnym zastąpieniem jest adres URL strony i opcjonalny link kotwicy („przeskok 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 dyskusji publicznej.
Odpowiada: ClaimReview.itemReviewed.datePublished.

claim_location

string

Lokalizacja zgłoszenia tego roszczenia.
Odpowiada: ClaimReview.itemReviewed.name.

claim_first_appearance

string

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

claim_appearances[]

string

Lista linków do utworów, w których pojawia się to roszczenie, oprócz tego określonego 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 opinii dotyczącej roszczenia.

Strona ClaimReviewMarkupPage

Zawiera co najmniej 1 instancję znaczników ClaimReview strony internetowej.

Pola
name

string

Nazwa zasobu strony znaczników ClaimReview w formacie pages/{page_id}. To pole jest przeznaczone tylko do przekazywania danych wyjściowych i nie powinno być ustawiane przez użytkownika.

page_url

string

Adres URL strony powiązanej ze znacznikami ClaimReview. Każdy element ClaimReview ma własne pole adresu URL, ale semantycznie jest to pole na poziomie strony. Każda wartość ClaimReview na tej stronie będzie korzystać z tej wartości, chyba że zostanie ona zastąpiona.
Odpowiada: ClaimReview.url

publish_date

string

Data publikacji informacji zweryfikowanych. Podobnie jak adres URL, to semantycznie jest to pole na poziomie strony. Każde ClaimReview na tej stronie będzie zawierać tę samą wartość.
Odpowiada: ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Informacje o autorze tej opinii. Podobnie jak powyżej, pola te mają znaczenie semantyczne, a każde ClaimReview na tej stronie będzie zawierać te same wartości.

claim_review_markups[]

ClaimReviewMarkup

Lista opinii o poszczególnych roszczeniach dotyczących tej strony. Każda pozycja na liście odpowiada jednemu elementowi ClaimReview.

version_id

string

Identyfikator wersji tych znaczników. To pole jest przeznaczone tylko do przekazywania danych wyjściowych i nie powinno być ustawiane przez użytkownika.

CreateClaimReviewMarkupPageRequest

Żądanie utworzenia znaczników ClaimReview na stronie.

Pola
claim_review_markup_page

ClaimReviewMarkupPage

Znaczniki ClaimReview do utworzenia tej strony. Jeśli dostępna jest bardziej kanoniczna wersja adresu URL strony, użyjemy tej.

Element RequestClaimReviewMarkupPageRequest

Żądanie usunięcia wszystkich znaczników ClaimReview na stronie.

Pola
name

string

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

Żądanie dotyczące informacji zweryfikowanych

Prośba o wyszukiwanie informacji zweryfikowanych.

Pola
query

string

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

language_code

string

Kod języka BCP-47, na przykład „en-US” lub „sr-Latn”. Można go używać do ograniczania wyników według języka, chociaż obecnie nie uwzględniamy tego regionu.

review_publisher_site_filter

string

Witryna wydawcy publikującego recenzje, aby filtrować wyniki, np. nytimes.com.

max_age_days

int32

Maksymalny wiek zwróconych wyników wyszukiwania (w dniach). Wiek jest ustalany na podstawie daty roszczenia lub daty sprawdzenia, w zależności od tego, która z tych dat jest nowsza.

page_size

int32

Rozmiar podziału na strony. Powrócimy do tylu wyników. Jeśli nie zostanie ustawiony, domyślna wartość to 10.

page_token

string

Podział na strony. Aby uzyskać następną stronę, możesz podać next_page_token zwrócone z poprzedniego żądania listy. Wszystkie pozostałe pola muszą mieć takie same wartości jak poprzednie żądanie.

offset

int32

Liczba całkowita określająca aktualne przesunięcie (czyli lokalizację początkową wyniku) w wynikach wyszukiwania. To pole jest uwzględniane tylko wtedy, gdy zasada page_token jest nieskonfigurowana. Na przykład 0 oznacza zwracanie wyników zaczynających się od pierwszego pasującego wyniku, a 10 – zwracanie wyników z 11.

odpowiedź dotycząca faktów

Odpowiedź dotycząca wyszukiwania twierdzeń zweryfikowanych.

Pola
claims[]

Claim

Lista roszczeń i powiązanych z nimi informacji.

next_page_token

string

Następny token podziału na strony w odpowiedzi wyszukiwania. Powinien być używany jako page_token w poniższym żądaniu. Pusta wartość oznacza, że nie ma więcej wyników.

GetClaimReviewMarkupPageRequest

Żądanie dodania znaczników ClaimReview na stronie.

Pola
name

string

Nazwa zasobu, który chcesz pobrać, w postaci pages/{page_id}.

ListaClaimReviewMarkupPagesRequest

Prośba o udostępnienie znaczników ClaimReview.

Pola
url

string

Adres URL, z którego chcesz uzyskać znaczniki ClaimReview. Występuje maksymalnie jeden wynik. Jeśli znaczniki są powiązane z bardziej kanoniczną wersją podanego adresu URL, zwrócimy go. Nie można go określić razem z organizacją.

organization

string

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

page_size

int32

Rozmiar podziału na strony. Powrócimy do tylu wyników. Jeśli nie zostanie ustawiony, domyślna wartość to 10. Nie działa, jeśli wymagany jest adres URL.

page_token

string

Podział na strony. Aby uzyskać następną stronę, możesz podać next_page_token zwrócone z poprzedniego żądania listy. Wszystkie pozostałe pola muszą mieć takie same wartości jak poprzednie żądanie.

offset

int32

Liczba całkowita określająca aktualne przesunięcie (czyli lokalizację początkową wyniku) w wynikach wyszukiwania. To pole jest uwzględniane tylko wtedy, gdy pole page_token jest nieskonfigurowane i żądanie nie odnosi się do konkretnego adresu URL. Na przykład 0 oznacza zwracanie wyników zaczynających się od pierwszego pasującego wyniku, a 10 – zwracanie wyników z 11.

ListaClaimReviewReviewMarkupPagesResponse

Odpowiedź z listy ClaimReview znaczników.

Pola
claim_review_markup_pages[]

ClaimReviewMarkupPage

Lista stron ze znacznikami ClaimReview.

next_page_token

string

Następny token podziału na strony w odpowiedzi wyszukiwania. Powinien być używany jako page_token w poniższym żądaniu. Pusta wartość oznacza, że nie ma więcej wyników.

Wydawca

Informacje o wydawcy.

Pola
name

string

Nazwa tego wydawcy. Przykład: „Doskonałe informacje zweryfikowane”.

site

string

Nazwa witryny na poziomie hosta bez protokołu i prefiksu „www”. Na przykład „awesomefactchecks.com”. Wartość tego pola opiera się wyłącznie na adresie URL weryfikacji roszczenia.

UpdateClaimReviewMarkupPageRequest

Żądanie aktualizacji wszystkich znaczników ClaimReview na stronie.

Pola
claim_review_markup_page

ClaimReviewMarkupPage

Zaktualizowane znaczniki ClaimReview na tej stronie. Żądania aktualizacji muszą określać zarówno nazwę zasobu, jak i identyfikator wersji zasobu do aktualizacji. Jeśli określony identyfikator wersji nie jest zgodny z identyfikatorem najnowszej wersji (co może się zdarzyć, jeśli znaczniki zostały zmienione od ostatniego odczytu), żądanie nie powiedzie się. Aktualizacje nie mogą też zmieniać adresu URL strony. Aby zmienić URL znaczników, usuń stare znaczniki i utwórz je ponownie z nowym adresem URL.