Package google.factchecking.factchecktools.v1alpha1

Índice

FactCheckToolsService

API Fact Check Tools

A API Fact Check Tools oferece acesso programático à funcionalidade disponibilizada pelo front-end das ferramentas de checagem de fatos do Google em https://g.co/factchecktools.

As APIs disponíveis no momento são:

  • Pesquisa de declarações checadas (fornecida pelo front-end do Buscador de checagem de fatos).
  • Pesquisa de declarações checadas por imagem (fornecida pela interface do Buscador de checagem de fatos).

  • Interface CRUD para marcação ClaimReview em uma página (fornecida pelo front-end da Ferramenta para marcação de checagem de fatos).

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Crie a marcação ClaimReview em uma página.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Exclua toda a marcação ClaimReview em uma página.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Pesquisar declarações verificadas usando uma imagem como consulta.
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Pesquise declarações verificadas.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Receba toda a marcação ClaimReview em uma página.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Liste as páginas de marcação ClaimReview de um URL específico ou de uma organização.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Atualizar toda a marcação ClaimReview em uma página

Essa é uma atualização completa. Para manter a marcação ClaimReview em uma página, primeiro faça uma operação "Get", modifique a marcação retornada e, por fim, chame "Update" com toda a marcação ClaimReview como corpo.

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Reivindicar

Informações sobre a reivindicação.

Campos
text

string

O texto da declaração. Por exemplo, "O crime dobrou nos últimos dois anos".
claimant

string

É a pessoa ou organização que faz a declaração. Por exemplo, "João Pereira".
claim_date

Timestamp

A data em que a reivindicação foi feita.
claim_review[]

ClaimReview

Uma ou mais revisões dessa declaração (ou seja, um artigo de verificação de fatos).

ClaimAuthor

Informações sobre o autor da declaração.

Campos
name

string

É a pessoa ou organização que faz a declaração. Por exemplo, "João Pereira".
Corresponde a ClaimReview.itemReviewed.author.name.
job_title

string

Corresponde a ClaimReview.itemReviewed.author.jobTitle.
image_url

string

Corresponde a ClaimReview.itemReviewed.author.image.
same_as

string

Corresponde a ClaimReview.itemReviewed.author.sameAs.

ClaimRating

Informações sobre a classificação da declaração.

Campos
textual_rating

string

É a avaliação de confiabilidade como uma frase ou palavra curta compreensível.
Corresponde a ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

É uma avaliação numérica da reivindicação, que vai de worstRating a bestRating, inclusive.
Corresponde a ClaimReview.reviewRating.ratingValue.
worst_rating

Int32Value

Em classificações numéricas, é o pior valor possível na escala de "pior" para "melhor".
Corresponde a ClaimReview.reviewRating.worstRating.
best_rating

Int32Value

Em classificações numéricas, é o melhor valor possível na escala de "pior" para "melhor".
Corresponde a ClaimReview.reviewRating.bestRating.
rating_explanation

string

Corresponde a ClaimReview.reviewRating.ratingExplanation.
image_url

string

Corresponde a ClaimReview.reviewRating.image.

ClaimReview

Informações sobre uma revisão de reivindicação.

Campos
publisher

Publisher

O editor desta análise de declaração.
url

string

O URL desta análise de declaração.
title

string

O título desta revisão de declaração, se puder ser determinado.
review_date

Timestamp

A data em que a reivindicação foi analisada.
textual_rating

string

Avaliação textual. Por exemplo, "Predominantemente falso".
language_code

string

O idioma em que a avaliação foi escrita. Por exemplo, "en" ou "de".

ClaimReviewAuthor

Informações sobre o autor da análise da declaração.

Campos
name

string

É o nome da organização que está publicando a checagem de fatos.
Corresponde a ClaimReview.author.name.
image_url

string

Corresponde a ClaimReview.author.image.

ClaimReviewMarkup

Campos para um elemento ClaimReview individual. Exceto para submensagens que agrupam campos, cada um desses campos corresponde aos de https://schema.org/ClaimReview. Listamos o mapeamento preciso de cada campo.

Campos
url

string

Esse campo é opcional e tem como padrão o URL da página. Fornecemos esse campo para permitir que você substitua o valor padrão, mas a única substituição permitida é o URL da página mais um link âncora opcional ("pulo de página").
Corresponde a ClaimReview.url
claim_reviewed

string

Um breve resumo da declaração que está sendo avaliada.
Corresponde a ClaimReview.claimReviewed.
claim_date

string

A data em que a declaração foi feita ou caiu em debate público.
Corresponde a ClaimReview.itemReviewed.datePublished.
claim_location

string

O local em que a declaração foi feita.
Corresponde a ClaimReview.itemReviewed.name.
claim_first_appearance

string

Um link para uma obra em que essa declaração aparece pela primeira vez.
Corresponde a ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.
claim_appearances[]

string

Uma lista de links para obras em que essa declaração aparece, além da especificada em claim_first_appearance.
Corresponde a ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Informações sobre o autor desta declaração.
rating

ClaimRating

Informações sobre a classificação desta revisão de declaração.

ClaimReviewMarkupPage

Contém uma ou mais instâncias de marcação ClaimReview para uma página da Web.

Campos
name

string

O nome deste recurso de página de marcação ClaimReview, no formato pages/{page_id}. Exceto para solicitações de atualização, esse campo é somente saída e não deve ser definido pelo usuário.
page_url

string

O URL da página associada a essa marcação ClaimReview. Embora cada ClaimReview individual tenha seu próprio campo de URL, semanticamente esse é um campo no nível da página, e cada ClaimReview nessa página usará esse valor, a menos que seja substituído individualmente.
Corresponde a ClaimReview.url
publish_date

string

A data em que a checagem de fatos foi publicada. Assim como o URL, semanticamente esse é um campo no nível da página, e cada ClaimReview nessa página vai conter o mesmo valor.
Corresponde a ClaimReview.datePublished
claim_review_author

ClaimReviewAuthor

Informações sobre o autor desta análise de declaração. Assim como acima, semanticamente, esses são campos no nível da página, e cada ClaimReview nesta página vai conter os mesmos valores.
claim_review_markups[]

ClaimReviewMarkup

Uma lista de análises de reivindicações individuais para esta página. Cada item da lista corresponde a um elemento ClaimReview.
version_id

string

O ID da versão desta marcação. Exceto para solicitações de atualização, esse campo é somente saída e não deve ser definido pelo usuário.

CreateClaimReviewMarkupPageRequest

Solicitação para criar a marcação ClaimReview em uma página.

Campos
claim_review_markup_page

ClaimReviewMarkupPage

A marcação ClaimReview a ser criada para esta página. Se houver uma versão mais canônica do URL da página fornecido, vamos usar essa versão.

DeleteClaimReviewMarkupPageRequest

Solicitação para excluir toda a marcação ClaimReview em uma página.

Campos
name

string

O nome do recurso a ser excluído, no formato pages/{page_id}.

FactCheckedClaimImageSearchRequest

Solicitação de pesquisa de declarações verificadas por imagem.

Campos
image_uri

string

Obrigatório. O URI da imagem de origem. Precisa ser um URL HTTP/HTTPS de imagem acessível publicamente.

Ao buscar imagens de URLs HTTP/HTTPS, o Google não pode garantir que a solicitação seja concluída. A solicitação poderá falhar se o host especificado negar a solicitação (por exemplo, por causa de limitação da solicitação ou prevenção de DOS) ou se o Google limitar as solicitações ao site para prevenção de abuso. Não convém depender de imagens hospedadas externamente para aplicativos de produção.
language_code

string

Opcional. O código de idioma BCP-47, como "pt-BR" ou "en-US". Pode ser usado para restringir os resultados por idioma, mas no momento não consideramos a região.
page_size

int32

Opcional. O tamanho da paginação. Vamos retornar até esse número de resultados. O padrão é 10, caso não esteja definido.
page_token

string

Opcional. O token de paginação. Você pode fornecer o next_page_token retornado de uma solicitação de lista anterior, se houver, para acessar a próxima página. Todos os outros campos precisam ter os mesmos valores da solicitação anterior.
offset

int32

Opcional. Um número inteiro que especifica o deslocamento atual (ou seja, o local do resultado inicial) nos resultados da pesquisa. Este campo só é considerado quando page_token não está definido. Por exemplo, 0 significa retornar resultados a partir do primeiro resultado correspondente, e 10 significa retornar a partir do 11º resultado.

FactCheckedClaimImageSearchResponse

Resposta da pesquisa de declarações checadas por imagem.

Campos
results[]

Result

A lista de reivindicações e todas as informações associadas a elas.
next_page_token

string

O próximo token de paginação na resposta da pesquisa. Ele deve ser usado como o page_token para a solicitação a seguir. Um valor vazio significa que não há mais resultados.

Resultado

Uma reivindicação e as informações associadas a ela.

Campos
claim

Claim

Uma declaração que correspondeu à consulta.

FactCheckedClaimSearchRequest

Solicitação para pesquisar declarações verificadas.

Campos
query

string

String de consulta textual. Obrigatório, a menos que review_publisher_site_filter seja especificado.
language_code

string

O código de idioma BCP-47, como "pt-BR" ou "en-US". Pode ser usado para restringir os resultados por idioma, mas no momento não consideramos a região.
review_publisher_site_filter

string

O site do editor de avaliações para filtrar os resultados, por exemplo, nytimes.com.
max_age_days

int32

A idade máxima dos resultados da pesquisa retornados, em dias. A idade é determinada pela data da reivindicação ou da avaliação, o que for mais recente.
page_size

int32

O tamanho da paginação. Vamos retornar até esse número de resultados. O padrão é 10, caso não esteja definido.
page_token

string

O token de paginação. Você pode fornecer o next_page_token retornado de uma solicitação de lista anterior, se houver, para acessar a próxima página. Todos os outros campos precisam ter os mesmos valores da solicitação anterior.
offset

int32

Um número inteiro que especifica o deslocamento atual (ou seja, o local do resultado inicial) nos resultados da pesquisa. Este campo só é considerado quando page_token não está definido. Por exemplo, 0 significa retornar resultados a partir do primeiro resultado correspondente, e 10 significa retornar a partir do 11º resultado.

FactCheckedClaimSearchResponse

Resposta da pesquisa de declarações verificadas.

Campos
claims[]

Claim

A lista de reivindicações e todas as informações associadas a elas.
next_page_token

string

O próximo token de paginação na resposta da pesquisa. Ele deve ser usado como o page_token para a solicitação a seguir. Um valor vazio significa que não há mais resultados.

GetClaimReviewMarkupPageRequest

Solicitação para receber a marcação ClaimReview em uma página.

Campos
name

string

O nome do recurso a ser recebido, no formato pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Solicitação para listar a marcação ClaimReview.

Campos
url

string

O URL de onde buscar a marcação ClaimReview. Haverá no máximo um resultado. Se a marcação estiver associada a uma versão mais canônica do URL fornecido, vamos retornar esse URL. Não pode ser especificado com uma organização.
organization

string

A organização para a qual queremos buscar as marcações. Por exemplo, "site.com". Não pode ser especificado com um URL.
page_size

int32

O tamanho da paginação. Vamos retornar até esse número de resultados. O padrão é 10, caso não esteja definido. Não tem efeito se um URL for solicitado.
page_token

string

O token de paginação. Você pode fornecer o next_page_token retornado de uma solicitação de lista anterior, se houver, para acessar a próxima página. Todos os outros campos precisam ter os mesmos valores da solicitação anterior.
offset

int32

Um número inteiro que especifica o deslocamento atual (ou seja, o local do resultado inicial) nos resultados da pesquisa. Este campo só é considerado quando page_token não está definido e a solicitação não é para um URL específico. Por exemplo, 0 significa retornar resultados a partir do primeiro resultado correspondente, e 10 significa retornar a partir do 11º resultado.

ListClaimReviewMarkupPagesResponse

Resposta da marcação de ClaimReview da página de detalhes.

Campos
claim_review_markup_pages[]

ClaimReviewMarkupPage

A lista de resultados de páginas de marcação ClaimReview.
next_page_token

string

O próximo token de paginação na resposta da pesquisa. Ele deve ser usado como o page_token para a solicitação a seguir. Um valor vazio significa que não há mais resultados.

Editor

Informações sobre o publisher.

Campos
name

string

O nome do editor. Por exemplo, "Awesome Fact Checks".
site

string

Nome do site no nível do host, sem o protocolo ou o prefixo "www". Por exemplo, "awesomefactchecks.com". O valor desse campo é baseado apenas no URL da revisão da declaração.

UpdateClaimReviewMarkupPageRequest

Solicitação para atualizar toda a marcação ClaimReview em uma página.

Campos
claim_review_markup_page

ClaimReviewMarkupPage

A marcação ClaimReview atualizada para esta página. As solicitações de atualização precisam especificar o nome do recurso e o ID da versão a ser atualizada. Se o ID da versão especificada não corresponder ao ID da versão da marcação mais recente (o que pode acontecer se a marcação tiver sido modificada desde a última leitura), a solicitação vai falhar. As atualizações também não podem mudar o URL da página. Para mudar o URL da marcação, exclua a marcação antiga e recrie-a com o novo URL.