Package google.factchecking.factchecktools.v1alpha1

Índice

ServicioDeHerramientasDeVerificaciónDeDatos

API de herramientas de verificación de datos

La API de Fact Check Tools proporciona acceso programático a la funcionalidad que se proporciona mediante el frontend de Google Fact Check Tools en https://g.co/factchecktools.

Las API disponibles actualmente son las siguientes:

  • Búsqueda de afirmaciones con verificación de datos (proporcionada a través del frontend del Explorador de verificación de datos)

  • Interfaz de CRUD para el lenguaje de marcado de ClaimReview en una página (proporcionada a través del frontend de la herramienta de marcado de verificación de datos)

CreateClaimReviewMarkupPage

rpc CreateClaimReviewMarkupPage(CreateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Crea lenguaje de marcado de ClaimReview en una página.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

Borra todo el lenguaje de marcado de ClaimReview en una página.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Realiza búsquedas mediante afirmaciones con verificación de datos.

GetClaimReviewMarkupPage.

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Obtén el lenguaje de marcado de ClaimReview en una página.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

Enumera las páginas de lenguaje de marcado de ClaimReview para una URL específica o de una organización.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Se actualizó para todo el lenguaje de marcado de ClaimReview en una página

Tenga en cuenta que esta es una actualización completa. Para mantener el lenguaje de marcado ClaimReview existente en una página, primero realiza una operación Get, luego, modifica el lenguaje de marcado que se muestra y, por último, llama a Update con todo el lenguaje de marcado ClaimReview como cuerpo.

Alcances de la autorización

Requiere el siguiente alcance de OAuth:

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

Reclamar

Información sobre el reclamo.

Campos
text

string

El texto del reclamo. Por ejemplo, “Crimen se duplicó en los últimos 2 años”.

claimant

string

Indica una persona u organización que declara el reclamo. Por ejemplo, "Juan Pérez".

claim_date

Timestamp

La fecha en que se realizó el reclamo

claim_review[]

ClaimReview

Una o más opiniones sobre esta declaración (es decir, un artículo de verificación de datos).

Autor del reclamo

Información sobre el autor del reclamo.

Campos
name

string

Indica una persona u organización que declara el reclamo. Por ejemplo, "Juan Pérez".
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.

Clasificación de reclamos

Información sobre la calificación del reclamo.

Campos
textual_rating

string

Es la clasificación de veracidad como una palabra o frase corta legible para las personas.
Corresponde a ClaimReview.reviewRating.alternateName.

rating_value

Int32Value

Calificación numérica de la declaración en el rango peorRating, bestRating inclusive.
Corresponde a ClaimReview.reviewRating.ratingValue.

worst_rating

Int32Value

En clasificaciones numéricas, corresponde al peor valor posible en la escala del peor al mejor.
Corresponde a ClaimReview.reviewRating.worstRating.

best_rating

Int32Value

En clasificaciones numéricas, corresponde al mejor valor posible en la escala del peor al mejor.
Corresponde a ClaimReview.reviewRating.bestRating.

rating_explanation

string

Corresponde a ClaimReview.reviewRating.ratingExplanation.

image_url

string

Corresponde a ClaimReview.reviewRating.image.

ClaimReview

Información sobre la revisión de un reclamo.

Campos
publisher

Publisher

Corresponde al editor de la revisión de este reclamo.

url

string

La URL de la revisión de este reclamo.

title

string

Es el título de la revisión de este reclamo, si se puede determinar.

review_date

Timestamp

La fecha en que se revisó el reclamo.

textual_rating

string

Calificación textual. Por ejemplo, "Principalmente falso".

language_code

string

El idioma en el que se escribió esta opinión. Por ejemplo, "en" o "de".

ClaimReviewAuthor

Incluye información sobre el autor de la verificación de hechos.

Campos
name

string

Es el nombre de la organización que publica la verificación de datos.
Corresponde a ClaimReview.author.name.

image_url

string

Corresponde a ClaimReview.author.image.

ClaimReviewMarkup

Campos para un elemento ClaimReview individual. A excepción de los mensajes secundarios que agrupan campos, cada uno de ellos corresponde a los de https://schema.org/ClaimReview. Enumeramos la asignación precisa para cada campo.

Campos
url

string

Este campo es opcional y se establecerá de forma predeterminada en la URL de la página. Proporcionamos este campo para permitir la anulación del valor predeterminado, pero la única anulación permitida es la de la página más un vínculo de anclaje opcional ("salto de página").
: corresponde a ClaimReview.url.

claim_reviewed

string

Un breve resumen de la declaración que se evalúa.
Corresponde a ClaimReview.claimReviewed.

claim_date

string

Fecha en la que se realizó o difundió públicamente la declaración.
Corresponde a ClaimReview.itemReviewed.datePublished.

claim_location

string

La ubicación donde se realizó este reclamo.
Corresponde a ClaimReview.itemReviewed.name.

claim_first_appearance

string

Es un vínculo a una obra en la que aparece por primera vez esta reclamación.
Corresponde a ClaimReview.itemReviewed[@type=Claim].firstAppearance.url.

claim_appearances[]

string

Lista de vínculos a las obras en las que aparece esta declaración, además del que se especificó en claim_first_appearance.
Corresponde a ClaimReview.itemReviewed[@type=Claim].appearance.url.

claim_author

ClaimAuthor

Información sobre el autor de este reclamo.

rating

ClaimRating

Información sobre la calificación de esta revisión de hechos.

Página de revisión de reclamos

Contiene una o más instancias de lenguaje de marcado de ClaimReview para una página web.

Campos
name

string

Es el nombre de este recurso de la página de lenguaje de marcado de ClaimReview, con el formato pages/{page_id}. A excepción de las solicitudes de actualización, este campo solo tiene formato de salida, y el usuario no debe establecerlo.

page_url

string

Es la URL de la página asociada con este lenguaje de marcado de ClaimReview. Si bien cada ClaimReview individual tiene su propio campo de URL, semánticamente, este es un campo de nivel de página, y cada ClaimReview de esta página usará este valor, a menos que se anule individualmente.
: corresponde a ClaimReview.url.

publish_date

string

Es la fecha en la que se publicó la verificación de datos. Al igual que la URL, este es un campo a nivel de la página y semántico, y cada ClaimReview de esta página contendrá el mismo valor.
: corresponde a ClaimReview.datePublished.

claim_review_author

ClaimReviewAuthor

Información sobre el autor de la revisión de este reclamo. De manera similar a lo anterior, los campos semánticos son a nivel de página y cada ClaimReview de esta página contendrá los mismos valores.

claim_review_markups[]

ClaimReviewMarkup

Lista de revisiones de reclamos individuales de esta página. Cada elemento de la lista corresponde a un elemento ClaimReview.

version_id

string

Es el ID de versión de este lenguaje de marcado. A excepción de las solicitudes de actualización, este campo solo tiene formato de salida, y el usuario no debe establecerlo.

CreateClaimReviewMarkupPageRequest

Solicitud para crear lenguaje de marcado de ClaimReview en una página

Campos
claim_review_markup_page

ClaimReviewMarkupPage

Es el lenguaje de marcado de ClaimReview que se creará para esta página. Si se proporciona una versión más canónica de la URL de la página, la utilizaremos en su lugar.

DeleteClaimReviewupUpRequestRequest

Solicitud para borrar todo el lenguaje de marcado de ClaimReview en una página.

Campos
name

string

El nombre del recurso que se borrará, con el formato pages/{page_id}.

FactCheckClaimSearchRequest

Solicitud para realizar búsquedas mediante afirmaciones con verificación de datos.

Campos
query

string

String de consulta textual. Es obligatorio, a menos que se especifique review_publisher_site_filter.

language_code

string

El código de idioma BCP-47, como "en-US" o "sr-Latn". Se puede usar para restringir los resultados por idioma, aunque actualmente no consideramos la región.

review_publisher_site_filter

string

El sitio del publicador de opiniones que se usará para filtrar los resultados, p. ej., nytimes.com

max_age_days

int32

Es la antigüedad máxima de los resultados de la búsqueda que se muestran, en días. La antigüedad se determina según la fecha del reclamo o de la revisión, lo que sea más reciente.

page_size

int32

Es el tamaño de la paginación. Mostraremos hasta tantos resultados. El valor predeterminado es 10 si no se establece.

page_token

string

El token de paginación Para poder pasar a la página siguiente, debes proporcionar la next_page_token que se mostró desde una solicitud de lista anterior. Todos los demás campos deben tener los mismos valores que en la solicitud anterior.

offset

int32

Un número entero que especifica el desfase actual (es decir, la ubicación inicial del resultado) en los resultados de la búsqueda. Este campo solo se considera si no estableces page_token. Por ejemplo, 0 significa que se mostrarán los resultados a partir del primer resultado coincidente y 10 significa que se mostrarán desde el undécimo resultado.

FactCheckClaimSearchResponse

Respuesta de la búsqueda de afirmaciones con verificación de datos.

Campos
claims[]

Claim

Lista de reclamos y toda su información asociada.

next_page_token

string

El siguiente token de paginación de la respuesta de la Búsqueda Debe usarse como page_token para la siguiente solicitud. Un valor vacío significa que no hay más resultados.

GetClaimReviewMarkupPageRequest.

Solicitud para obtener el lenguaje de marcado de ClaimReview en una página.

Campos
name

string

El nombre del recurso que se debe obtener, con el formato pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Solicitud para mostrar el lenguaje de marcado de ClaimReview.

Campos
url

string

La URL desde la que se obtiene el lenguaje de marcado de ClaimReview. Solo habrá un resultado. Si el lenguaje de marcado está asociado a una versión más canónica de la URL proporcionada, mostraremos esa URL en su lugar. No se puede especificar junto con una organización.

organization

string

La organización para la que queremos recuperar lenguaje de marcado. Por ejemplo, “sitio.com”. No se puede especificar junto con una URL.

page_size

int32

Es el tamaño de la paginación. Mostraremos hasta tantos resultados. El valor predeterminado es 10 si no se establece. No tiene ningún efecto si se solicita una URL.

page_token

string

El token de paginación Para poder pasar a la página siguiente, debes proporcionar la next_page_token que se mostró desde una solicitud de lista anterior. Todos los demás campos deben tener los mismos valores que en la solicitud anterior.

offset

int32

Un número entero que especifica el desfase actual (es decir, la ubicación inicial del resultado) en los resultados de la búsqueda. Este campo solo se considera si no estableces page_token y si la solicitud no es para una URL específica. Por ejemplo, 0 significa que se mostrarán los resultados a partir del primer resultado coincidente y 10 significa que se mostrarán desde el undécimo resultado.

ListClaimReviewMarkupPagesResponse

Respuesta a partir del lenguaje de marcado de ClaimReview.

Campos
claim_review_markup_pages[]

ClaimReviewMarkupPage

La lista de resultados de las páginas de lenguaje de marcado de ClaimReview

next_page_token

string

El siguiente token de paginación de la respuesta de la Búsqueda Debe usarse como page_token para la siguiente solicitud. Un valor vacío significa que no hay más resultados.

Publicador

Información sobre el publicador.

Campos
name

string

Corresponde al nombre de este publicador. Por ejemplo, "Verificación de datos impresionantes".

site

string

Nombre del sitio a nivel del host sin el protocolo ni el prefijo "www". Por ejemplo, "fabulosasverificaciones.com". Este valor se basa puramente en la URL de revisión de reclamo.

UpdateClaimReviewMarkupPageRequest

Solicitud para actualizar todo el lenguaje de marcado de ClaimReview en una página

Campos
claim_review_markup_page

ClaimReviewMarkupPage

Se actualizó el lenguaje de marcado de ClaimReview de esta página. Las solicitudes de actualización deben especificar el nombre del recurso y el ID de la versión del recurso que se actualizará. Si el ID de versión especificado no coincide con el ID de versión del lenguaje de marcado más reciente (que puede ocurrir si se modificó el lenguaje de marcado desde la última lectura), la solicitud fallará. Las actualizaciones tampoco deben cambiar la URL de la página. Para cambiar la URL del lenguaje de marcado, borra el lenguaje de marcado anterior y vuelve a crearlo con la URL nueva.