Package google.factchecking.factchecktools.v1alpha1

Индекс

FactCheckИнструментыСервис

API инструментов проверки фактов

API инструментов проверки фактов обеспечивает программный доступ к функциям, предоставляемым через внешний интерфейс инструментов проверки фактов Google по адресу https://g.co/factchecktools .

Текущие доступные API:

  • Поиск заявлений с проверкой фактов (предоставляется через интерфейс Fact Check Explorer).

  • Интерфейс CRUD для разметки ClaimReview на странице (предоставляется через внешний интерфейс инструмента проверки фактов).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage( CreateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

Создайте разметку ClaimReview на странице.

Области авторизации

Требуется следующая область действия OAuth:

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

rpc DeleteClaimReviewMarkupPage( DeleteClaimReviewMarkupPageRequest ) returns ( Empty )

Удалите всю разметку ClaimReview на странице.

Области авторизации

Требуется следующая область действия OAuth:

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

rpc FactCheckedClaimSearch( FactCheckedClaimSearchRequest ) returns ( FactCheckedClaimSearchResponse )

Поиск среди утверждений, проверенных фактами.

GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage( GetClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

Получите всю разметку ClaimReview на странице.

Области авторизации

Требуется следующая область действия OAuth:

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

rpc ListClaimReviewMarkupPages( ListClaimReviewMarkupPagesRequest ) returns ( ListClaimReviewMarkupPagesResponse )

Перечислите страницы разметки ClaimReview для определенного URL-адреса или для организации.

Области авторизации

Требуется следующая область действия OAuth:

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

rpc UpdateClaimReviewMarkupPage( UpdateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

Обновление для всей разметки ClaimReview на странице

Обратите внимание, что это полное обновление. Чтобы сохранить существующую разметку ClaimReview на странице, сначала выполните операцию Get, затем измените возвращенную разметку и, наконец, вызовите Update со всей разметкой ClaimReview в качестве тела.

Области авторизации

Требуется следующая область действия OAuth:

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

Требовать

Информация об иске.

Поля
text

string

Текст претензии. Например, «Преступность удвоилась за последние 2 года».

claimant

string

Лицо или организация, заявляющая претензию. Например, «Джон Доу».

claim_date

Timestamp

Дата подачи претензии.

claim_review[]

ClaimReview

Один или несколько обзоров этого утверждения (а именно, статья для проверки фактов).

ПретензияАвтор

Информация об авторе претензии.

Поля
name

string

Лицо или организация, заявляющая претензию. Например, «Джон Доу».
Соответствует ClaimReview.itemReviewed.author.name .

job_title

string

Соответствует ClaimReview.itemReviewed.author.jobTitle .

image_url

string

Соответствует ClaimReview.itemReviewed.author.image .

same_as

string

Соответствует ClaimReview.itemReviewed.author.sameAs .

ПретензияРейтинг

Информация о рейтинге заявок.

Поля
textual_rating

string

Рейтинг правдивости в виде удобочитаемого короткого слова или фразы.
Соответствует ClaimReview.reviewRating.alternateName .

rating_value

Int32Value

Числовой рейтинг этого утверждения в диапазоне от худшего до лучшего рейтинга включительно.
Соответствует ClaimReview.reviewRating.ratingValue .

worst_rating

Int32Value

Для числовых оценок наихудшее возможное значение по шкале от худшего к лучшему.
Соответствует ClaimReview.reviewRating.worstRating .

best_rating

Int32Value

Для числовых оценок — наилучшее возможное значение по шкале от худшего к лучшему.
Соответствует ClaimReview.reviewRating.bestRating .

rating_explanation

string

Соответствует ClaimReview.reviewRating.ratingExplanation .

image_url

string

Соответствует ClaimReview.reviewRating.image .

ПретензияОбзор

Информация о рассмотрении претензии.

Поля
publisher

Publisher

Издатель этой заявки проверяет.

url

string

URL-адрес проверки этой заявки.

title

string

Название рассмотрения этой заявки, если его можно определить.

review_date

Timestamp

Дата рассмотрения претензии.

textual_rating

string

Текстовый рейтинг. Например, «В основном ложь».

language_code

string

Язык, на котором написан этот обзор. Например, «en» или «de».

ПретензияОбзорАвтор

Информация об авторе рассмотрения претензии.

Поля
name

string

Название организации, публикующей проверку фактов.
Соответствует ClaimReview.author.name .

image_url

string

Соответствует ClaimReview.author.image .

ПретензияОбзорРазметка

Поля для отдельного элемента ClaimReview . За исключением вложенных сообщений, которые группируют поля вместе, каждое из этих полей соответствует полям в https://schema.org/ClaimReview . Мы перечисляем точное сопоставление для каждого поля.

Поля
url

string

Это поле является необязательным и по умолчанию содержит URL-адрес страницы. Мы предоставляем это поле, чтобы вы могли переопределить значение по умолчанию, но единственным допустимым переопределением является URL-адрес страницы плюс необязательная якорная ссылка («переход на страницу»).
Соответствует ClaimReview.url

claim_reviewed

string

Краткое изложение рассматриваемого заявления.
Соответствует ClaimReview.claimReviewed .

claim_date

string

Дата, когда претензия была сделана или стала публичной дискуссией.
Соответствует ClaimReview.itemReviewed.datePublished .

claim_location

string

Место, где было сделано это заявление.
Соответствует ClaimReview.itemReviewed.name .

claim_first_appearance

string

Ссылка на произведение, в котором это утверждение впервые появляется.
Соответствует ClaimReview.itemReviewed[@type=Claim].firstAppearance.url .

claim_appearances[]

string

Список ссылок на работы, в которых появляется это утверждение, помимо указанного в claim_first_appearance .
Соответствует ClaimReview.itemReviewed[@type=Claim].appearance.url .

claim_author

ClaimAuthor

Информация об авторе этой претензии.

rating

ClaimRating

Информация о рейтинге рассмотрения этой заявки.

ClaimReviewMarkupPage

Содержит один или несколько экземпляров разметки ClaimReview для веб-страницы.

Поля
name

string

Имя этого ресурса страницы разметки ClaimReview в формате pages/{page_id} . За исключением запросов на обновление, это поле предназначено только для вывода и не должно задаваться пользователем.

page_url

string

URL-адрес страницы, связанной с этой разметкой ClaimReview . Хотя у каждого отдельного ClaimReview есть собственное поле URL-адреса, семантически это поле уровня страницы, и каждый ClaimReview на этой странице будет использовать это значение, если оно не переопределено отдельно.
Соответствует ClaimReview.url

publish_date

string

Дата публикации проверки фактов. Подобно URL-адресу, семантически это поле уровня страницы, и каждый ClaimReview на этой странице будет содержать одно и то же значение.
Соответствует ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Информация об авторе этого отзыва. Как и выше, семантически это поля уровня страницы, и каждый ClaimReview на этой странице будет содержать одни и те же значения.

claim_review_markups[]

ClaimReviewMarkup

Список отзывов отдельных претензий для этой страницы. Каждый элемент в списке соответствует одному элементу ClaimReview .

version_id

string

Идентификатор версии для этой разметки. За исключением запросов на обновление, это поле предназначено только для вывода и не должно задаваться пользователем.

CreateClaimReviewMarkupPageRequest

Запрос на создание разметки ClaimReview на странице.

Поля
claim_review_markup_page

ClaimReviewMarkupPage

ClaimReview , которую необходимо создать для этой страницы. Если предоставлена ​​более каноническая версия URL-адреса страницы, мы будем использовать ее.

DeleteClaimReviewMarkupPageRequest

Запрос на удаление всей разметки ClaimReview на странице.

Поля
name

string

Имя удаляемого ресурса в формате pages/{page_id} .

FactCheckedClaimSearchRequest

Запрос на поиск по проверенным утверждениям.

Поля
query

string

Текстовая строка запроса. Требуется, если не указан review_publisher_site_filter .

language_code

string

Код языка BCP-47, например «en-US» или «sr-Latn». Может использоваться для ограничения результатов по языку, хотя в настоящее время мы не учитываем регион.

review_publisher_site_filter

string

Сайт издателя обзоров для фильтрации результатов, например nytimes.com.

max_age_days

int32

Максимальный возраст возвращаемых результатов поиска в днях. Возраст определяется либо по дате подачи заявления, либо по дате пересмотра, в зависимости от того, что наступит раньше.

page_size

int32

Размер страницы. Мы вернемся к этому количеству результатов. По умолчанию 10, если не установлено.

page_token

string

Маркер страницы. Вы можете предоставить next_page_token возвращенный из предыдущего запроса списка, если таковой имеется, чтобы получить следующую страницу. Все остальные поля должны иметь те же значения, что и в предыдущем запросе.

offset

int32

Целое число, указывающее текущее смещение (то есть начальное местоположение результата) в результатах поиска. Это поле учитывается только в том случае, если page_token не установлен. Например, 0 означает возврат результатов, начиная с первого совпадающего результата, а 10 означает возврат с 11-го результата.

FactCheckedClaimSearchResponse

Ответ от поиска утверждений, проверенных фактами.

Поля
claims[]

Claim

Список претензий и вся связанная с ними информация.

next_page_token

string

Следующий токен разбивки на страницы в ответе поиска. Его следует использовать в качестве page_token для следующего запроса. Пустое значение означает отсутствие результатов.

GetClaimReviewMarkupPageRequest

Запрос на получение разметки ClaimReview на странице.

Поля
name

string

Имя получаемого ресурса в формате pages/{page_id} .

ListClaimReviewMarkupPagesRequest

Запрос на листинг разметки ClaimReview .

Поля
url

string

URL-адрес, из которого можно получить разметку ClaimReview . Будет максимум один результат. Если разметка связана с более канонической версией предоставленного URL-адреса, вместо этого мы вернем этот URL-адрес. Нельзя указывать вместе с организацией.

organization

string

Организация, для которой мы хотим получить наценки. Например, «site.ru». Нельзя указывать вместе с URL.

page_size

int32

Размер страницы. Мы вернемся к этому количеству результатов. По умолчанию 10, если не установлено. Не действует, если запрашивается URL.

page_token

string

Маркер страницы. Вы можете предоставить next_page_token возвращенный из предыдущего запроса списка, если таковой имеется, чтобы получить следующую страницу. Все остальные поля должны иметь те же значения, что и в предыдущем запросе.

offset

int32

Целое число, указывающее текущее смещение (то есть начальное местоположение результата) в результатах поиска. Это поле учитывается только в том случае, если page_token не задано и если запрос не для определенного URL-адреса. Например, 0 означает возврат результатов, начиная с первого совпадающего результата, а 10 означает возврат с 11-го результата.

ListClaimReviewMarkupPagesResponse

Ответ от листинга разметки ClaimReview .

Поля
claim_review_markup_pages[]

ClaimReviewMarkupPage

Результирующий список страниц разметки ClaimReview .

next_page_token

string

Следующий токен разбивки на страницы в ответе поиска. Его следует использовать в качестве page_token для следующего запроса. Пустое значение означает отсутствие результатов.

Издатель

Информация об издателе.

Поля
name

string

Название этого издателя. Например, «Потрясающие проверки фактов».

site

string

Имя сайта на уровне хоста без протокола или префикса «www». Например, «awesomefactchecks.com». Это значение этого поля основано исключительно на URL-адресе проверки заявки.

UpdateClaimReviewMarkupPageRequest

Запрос на обновление всей разметки ClaimReview на странице.

Поля
claim_review_markup_page

ClaimReviewMarkupPage

Обновленная разметка ClaimReview для этой страницы. В запросах на обновление должны быть указаны как имя ресурса, так и идентификатор версии ресурса для обновления. Если указанный идентификатор версии не соответствует идентификатору версии последней разметки (что может произойти, если разметка была изменена с момента последнего чтения), этот запрос завершится ошибкой. Обновления также не должны изменять URL-адрес страницы. Чтобы изменить URL-адрес разметки, удалите старую разметку и создайте ее заново с новым URL-адресом.