Package google.factchecking.factchecktools.v1alpha1

Индекс

FactCheckToolsService

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

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

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

  • Поиск проверенных фактов (через интерфейс Fact Check Explorer).
  • Поиск проверенных фактов по изображению (через интерфейс Fact Check Explorer).

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

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage( CreateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

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

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

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

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

rpc DeleteClaimReviewMarkupPage( DeleteClaimReviewMarkupPageRequest ) returns ( Empty )

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

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

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

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

rpc FactCheckedClaimImageSearch( FactCheckedClaimImageSearchRequest ) returns ( FactCheckedClaimImageSearchResponse )

Поиск по проверенным фактам утверждениям, используя изображение в качестве запроса.

FactCheckedClaimSearch

rpc FactCheckedClaimSearch( FactCheckedClaimSearchRequest ) returns ( FactCheckedClaimSearchResponse )

Поиск среди проверенных фактов.

GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage( GetClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

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

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

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

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

rpc ListClaimReviewMarkupPages( ListClaimReviewMarkupPagesRequest ) returns ( ListClaimReviewMarkupPagesResponse )

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

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

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

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

rpc UpdateClaimReviewMarkupPage( UpdateClaimReviewMarkupPageRequest ) returns ( ClaimReviewMarkupPage )

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

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

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

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

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

Требовать

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

Поля
text

string

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

claimant

string

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

claim_date

Timestamp

Дата подачи заявления.

claim_review[]

ClaimReview

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

ClaimAuthor

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

Поля
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 .

ClaimRating

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

Поля
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 .

ClaimReview

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

Поля
publisher

Publisher

Издатель данного обзора претензии.

url

string

URL-адрес обзора данной претензии.

title

string

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

review_date

Timestamp

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

textual_rating

string

Текстовая оценка. Например, «В основном ложно».

language_code

string

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

ClaimReviewAuthor

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

Поля
name

string

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

image_url

string

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

ClaimReviewMarkup

Поля для отдельного элемента 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} .

FactCheckedClaimImageSearchRequest

Запрос на поиск по изображениям проверенных фактов.

Поля
image_uri

string

Обязательно. URI исходного изображения. Это должен быть общедоступный URL-адрес изображения HTTP/HTTPS.

При загрузке изображений с URL-адресов HTTP/HTTPS Google не может гарантировать выполнение запроса. Запрос может быть отклонен, если указанный хост отклонит его (например, из-за ограничения запросов или предотвращения DOS-атак) или если Google ограничивает запросы к сайту для предотвращения злоупотреблений. Не следует полагаться на изображения, размещенные на внешних ресурсах, для производственных приложений.

language_code

string

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

page_size

int32

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

page_token

string

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

offset

int32

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

FactCheckedClaimImageSearchResponse

Ответ на поиск проверенных фактов по изображению.

Поля
results[]

Result

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

next_page_token

string

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

Результат

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

Поля
claim

Claim

Утверждение, соответствующее запросу.

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 , возвращенный из предыдущего запроса List (если таковой имеется), для получения следующей страницы. Все остальные поля должны иметь те же значения, что и в предыдущем запросе.

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.com». Нельзя указать вместе с URL-адресом.

page_size

int32

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

page_token

string

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

offset

int32

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

СписокЗаявкаОбзорРазметкаСтраницыОтвет

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

Поля
claim_review_markup_pages[]

ClaimReviewMarkupPage

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

next_page_token

string

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

Издатель

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

Поля
name

string

Название этого издательства. Например, «Awesome Fact Checks».

site

string

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

UpdateClaimReviewMarkupPageRequest

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

Поля
claim_review_markup_page

ClaimReviewMarkupPage

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