Package google.factchecking.factchecktools.v1alpha1

Índice

Serviço de verificação de fatos

API Fact Check Tools

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

As APIs disponíveis atualmente são:

  • Pesquisa de declaração de checagem de fatos fornecida pela interface do Explorador de checagem de fatos

  • Interface CRUD para a marcação ClaimReview em uma página (fornecida por meio da interface da Ferramenta de 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/userinfo.email
DeleteClaimReviewMarkupPage

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Excluir toda a marcação ClaimReview de uma página.

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/userinfo.email
Pesquisa de fatos

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Pesquise reivindicações verificadas.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

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

Escopos de autorização

Requer o seguinte escopo OAuth:

  • https://www.googleapis.com/auth/userinfo.email
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/userinfo.email
UpdateClaimReviewMarkupPage

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Atualização para todas as marcações do ClaimReview em uma página

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

Escopos de autorização

Requer o seguinte escopo OAuth:

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

Reivindicar

Informações sobre a reivindicação.

Campos
text

string

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

claimant

string

Uma pessoa ou organização que afirma a reivindicação. Por exemplo, "João da Silva".

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 checagem de fatos).

Reivindicador

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

Campos
name

string

Uma pessoa ou organização que afirma a reivindicação. Por exemplo, "João da Silva".
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.

Classificação da reivindicação

Informações sobre a classificação da reivindicaçã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 pior avaliação a bestRating, inclusive.
Corresponde a ClaimReview.reviewRating.ratingValue.

worst_rating

Int32Value

Em classificações numéricas, é o pior valor possível em uma 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 análise de declaração.

Campos
publisher

Publisher

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

url

string

O URL desta análise de reivindicação.

title

string

O título desta avaliação de reivindicação, se possível.

review_date

Timestamp

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

textual_rating

string

Classificaçã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 avaliação de reivindicaçã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 (em inglês)

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

Campos
url

string

Este campo é opcional e o padrão será 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 de âncora opcional ("page jump").
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 reivindicação foi feita ou inserida em discurso público.
Corresponde a ClaimReview.itemReviewed.datePublished.

claim_location

string

O local em que esta reivindicação foi feita.
Corresponde a ClaimReview.itemReviewed.name.

claim_first_appearance

string

Um link para uma obra em que essa reivindicaçã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 reivindicação aparece, além daquela especificada em claim_first_appearance.
Corresponde a ClaimReview.itemReviewed[@type=Claim].appearance.url.

claim_author

ClaimAuthor

Informações sobre o autor desta reivindicação.

rating

ClaimRating

Informações sobre a classificação dessa avaliação de declaração.

Página de reivindicação de reivindicação

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

Campos
name

string

O nome deste recurso de página de marcação ClaimReview, na forma de 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 de 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 nesta página usará esse valor, a menos que seja modificado individualmente.
Corresponde a ClaimReview.url

publish_date

string

É a data em que a checagem de fatos foi publicada. Semelhante ao URL, este é um campo de nível de página semântico, e cada ClaimReview da página terá o mesmo valor.
Corresponde a ClaimReview.datePublished

claim_review_author

ClaimReviewAuthor

Informações sobre o autor desta análise de declaração. Semelhante ao exemplo acima, esses são campos de nível de página semântico, e cada ClaimReview da página terá os mesmos valores.

claim_review_markups[]

ClaimReviewMarkup

Uma lista de avaliações de reivindicações individuais para esta página. Cada item na lista corresponde a um elemento ClaimReview.

version_id

string

O código da versão dessa 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 fornecida, ela será usada.

DeleteClaimReviewMarkupPageRequest

Solicitação para excluir todas as marcações ClaimReview de uma página.

Campos
name

string

O nome do recurso a ser excluído, na forma de pages/{page_id}.

FactCheckedClaimSearchRequest

Solicitação para pesquisar reivindicaçõ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 "en-US" ou "sr-Latn". Pode ser usado para restringir os resultados por idioma, mas não consideramos a região no momento.

review_publisher_site_filter

string

O site do editor de resenhas para filtrar os resultados, por exemplo, nytimes.com.

max_age_days

int32

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

page_size

int32

O tamanho da paginação. Retornaremos até esse número de resultados. O padrão é 10 caso não seja definido.

page_token

string

O token de paginação. Você pode fornecer o next_page_token retornado por 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 (isto é, o local de início do resultado) 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 do 11o resultado.

FactCheckedClaimSearchResponse

Resposta de pesquisas de checagem de fatos.

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 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 que será recebido, na forma de pages/{page_id}.

ListClaimReviewMarkupPagesRequest

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

Campos
url

string

O URL que deve receber 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, retornaremos esse URL. Não pode ser especificado junto com uma organização.

organization

string

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

page_size

int32

O tamanho da paginação. Retornaremos até esse número de resultados. O padrão é 10 caso não seja 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 por 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 (isto é, o local de início do resultado) nos resultados da pesquisa. Este campo só será considerado se page_token não estiver definido e se a solicitação não for para um URL específico. Por exemplo, 0 significa retornar resultados a partir do primeiro resultado correspondente e 10 significa retornar do 11o resultado.

ListClaimReviewMarkupPagesResponse

Resposta da listagem de marcação ClaimReview.

Campos
claim_review_markup_pages[]

ClaimReviewMarkupPage

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

next_page_token

string

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

Editor

São informações sobre o editor.

Campos
name

string

É o nome deste editor. Por exemplo, "Checagem de fatos incrível".

site

string

Nome do site no nível do host, sem o protocolo ou o prefixo "www". Por exemplo, "awesomefactchecks.com". Esse valor deste campo se baseia somente no URL da análise de reivindicaçã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 e o código da versão do recurso a ser atualizado. 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), essa solicitação falhará. As atualizações também não podem alterar o URL da página. Para alterar o URL da marcação, exclua a marcação antiga e recrie-a com o novo URL.