Package google.factchecking.factchecktools.v1alpha1

Índice

FactCheckToolsService

API de Fact Check Tools

La API de Fact Check Tools proporciona acceso programático a la funcionalidad que se ofrece a través del frontend de las herramientas de verificación de datos de Google en https://g.co/factchecktools.

Las APIs disponibles actualmente son las siguientes:

  • Búsqueda de reclamos verificados (se proporciona a través del frontend del Explorador de Verificación de datos)
  • Búsqueda de reclamos verificados por imagen (se proporciona a través de la interfaz del explorador de Verificación de datos)

  • Interfaz de CRUD para el lenguaje de marcado 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 un lenguaje de marcado ClaimReview en una página.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

rpc DeleteClaimReviewMarkupPage(DeleteClaimReviewMarkupPageRequest) returns (Empty)

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

rpc FactCheckedClaimImageSearch(FactCheckedClaimImageSearchRequest) returns (FactCheckedClaimImageSearchResponse)

Buscar afirmaciones verificadas con una imagen como consulta
FactCheckedClaimSearch

rpc FactCheckedClaimSearch(FactCheckedClaimSearchRequest) returns (FactCheckedClaimSearchResponse)

Busca entre las afirmaciones verificadas.
GetClaimReviewMarkupPage

rpc GetClaimReviewMarkupPage(GetClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Obtiene todo el marcado ClaimReview de una página.

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

rpc ListClaimReviewMarkupPages(ListClaimReviewMarkupPagesRequest) returns (ListClaimReviewMarkupPagesResponse)

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

rpc UpdateClaimReviewMarkupPage(UpdateClaimReviewMarkupPageRequest) returns (ClaimReviewMarkupPage)

Actualiza todo el lenguaje de marcado de ClaimReview en una página

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

Permisos de autorización

Requiere el siguiente alcance de OAuth:

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

Reclamar

Es información sobre el reclamo.

Campos
text

string

Es el texto de la afirmación. Por ejemplo, "Los delitos se duplicaron en los últimos 2 años".
claimant

string

Es la persona u organización que presenta el reclamo. Por ejemplo, "Juan Pérez".
claim_date

Timestamp

Es la fecha en que se presentó el reclamo.
claim_review[]

ClaimReview

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

ClaimAuthor

Es la información sobre el autor del reclamo.

Campos
name

string

Es la persona u organización que presenta 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.

ClaimRating

Es información sobre la clasificación de la afirmación.

Campos
textual_rating

string

Es la clasificación de veracidad en formato de frase o palabra legible para las personas.
Corresponde a ClaimReview.reviewRating.alternateName.
rating_value

Int32Value

Es la calificación numérica de la declaración en el rango worstRating—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

Es información sobre una revisión de reclamo.

Campos
publisher

Publisher

Es el editor de esta revisión de reclamo.
url

string

Es la URL de esta revisión de reclamo.
title

string

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

Timestamp

Es la fecha en que se revisó el reclamo.
textual_rating

string

Es una calificación textual. Por ejemplo, "Mayormente falso".
language_code

string

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

ClaimReviewAuthor

Es la información sobre el autor de la revisión de reclamo.

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

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

Campos
url

string

Este campo es opcional y, de forma predeterminada, se establecerá la URL de la página. Proporcionamos este campo para permitirte anular el valor predeterminado, pero la única anulación permitida es la URL 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

Es la ubicación en la que se realizó este reclamo.
Corresponde a ClaimReview.itemReviewed.name.
claim_first_appearance

string

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

string

Es una lista de vínculos a obras en las que aparece esta declaración, además de la que se especifica en claim_first_appearance.
Corresponde a ClaimReview.itemReviewed[@type=Claim].appearance.url.
claim_author

ClaimAuthor

Es la información sobre el autor de esta afirmación.
rating

ClaimRating

Es información sobre la calificación de esta revisión de reclamo.

ClaimReviewMarkupPage

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

Campos
name

string

Nombre de este recurso de página de marcado ClaimReview, con el formato pages/{page_id}. Excepto en el caso de las solicitudes de actualización, este campo es solo 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 es un campo a nivel de la página, y cada ClaimReview de esta página usará este valor, a menos que se anule de forma individual.
corresponde a ClaimReview.url
publish_date

string

La fecha en la que se publicó la verificación de datos. Al igual que la URL, semánticamente, este es un campo a nivel de la página, 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 esta revisión de reclamo. Al igual que en el caso anterior, semánticamente, estos son campos a nivel de la página, y cada ClaimReview de esta página contendrá los mismos valores.
claim_review_markups[]

ClaimReviewMarkup

Es una lista de las verificaciones de reclamos individuales para 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. Excepto en el caso de las solicitudes de actualización, este campo es solo de salida y el usuario no debe establecerlo.

CreateClaimReviewMarkupPageRequest

Es una solicitud para crear un lenguaje de marcado ClaimReview en una página.

Campos
claim_review_markup_page

ClaimReviewMarkupPage

Es el marcado 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, usaremos esa en su lugar.

DeleteClaimReviewMarkupPageRequest

Es la solicitud para borrar todo el lenguaje de marcado de ClaimReview en una página.

Campos
name

string

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

FactCheckedClaimImageSearchRequest

Solicitud para buscar afirmaciones verificadas por imágenes.

Campos
image_uri

string

Es obligatorio. El URI de la imagen de origen. Debe ser una URL HTTP/HTTPS de imagen de acceso público.

Cuando se recuperan imágenes de URLs HTTP/HTTPS, Google no puede garantizar que se completará la solicitud. Tu solicitud puede fallar si el host especificado niega la solicitud (p.ej., debido a una regulación de solicitud o una prevención de DoS) o si Google regula las solicitudes al sitio para evitar abusos. No debes depender de imágenes alojadas de forma externa para las aplicaciones de producción.
language_code

string

Opcional. 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.
page_size

int32

Opcional. Es el tamaño de la paginación. Devolveremos hasta esa cantidad de resultados. Si no se establece, el valor predeterminado es 10.
page_token

string

Opcional. Es el token de paginación. Puedes proporcionar el next_page_token que se devolvió de una solicitud de List anterior, si existe, para obtener la página siguiente. Todos los demás campos deben tener los mismos valores que en la solicitud anterior.
offset

int32

Opcional. Es un número entero que especifica la compensación actual (es decir, la ubicación del resultado inicial) en los resultados de la búsqueda. Este campo solo se tiene en cuenta si page_token no está configurado. Por ejemplo, 0 significa que se devolverán los resultados a partir del primer resultado coincidente, y 10 significa que se devolverán a partir del undécimo resultado.

FactCheckedClaimImageSearchResponse

Respuesta de la búsqueda de afirmaciones verificadas por imagen.

Campos
results[]

Result

Es la lista de reclamos y toda la información asociada.
next_page_token

string

Es el siguiente token de paginación en la respuesta de Search. Se debe usar como page_token para la siguiente solicitud. Un valor vacío significa que no hay más resultados.

Resultado

Es un reclamo y su información asociada.

Campos
claim

Claim

Es un reclamo que coincidió con la búsqueda.

FactCheckedClaimSearchRequest

Es una solicitud para buscar afirmaciones verificadas.

Campos
query

string

Es la cadena de consulta textual. 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

Es el sitio del publicador de opiniones por el que se filtrarán los resultados, p.ej., nytimes.com.
max_age_days

int32

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

int32

Es el tamaño de la paginación. Devolveremos hasta esa cantidad de resultados. Si no se establece, el valor predeterminado es 10.
page_token

string

Es el token de paginación. Puedes proporcionar el next_page_token que se devolvió de una solicitud de List anterior, si existe, para obtener la página siguiente. Todos los demás campos deben tener los mismos valores que en la solicitud anterior.
offset

int32

Es un número entero que especifica la compensación actual (es decir, la ubicación del resultado inicial) en los resultados de la búsqueda. Este campo solo se tiene en cuenta si page_token no está configurado. Por ejemplo, 0 significa que se devolverán los resultados a partir del primer resultado coincidente, y 10 significa que se devolverán a partir del undécimo resultado.

FactCheckedClaimSearchResponse

Es la respuesta de la búsqueda de afirmaciones verificadas.

Campos
claims[]

Claim

Es la lista de reclamos y toda la información asociada.
next_page_token

string

Es el siguiente token de paginación en la respuesta de Search. Se debe usar como page_token para la siguiente solicitud. Un valor vacío significa que no hay más resultados.

GetClaimReviewMarkupPageRequest

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

Campos
name

string

Nombre del recurso que se obtendrá, con el formato pages/{page_id}.

ListClaimReviewMarkupPagesRequest

Es una solicitud para enumerar el lenguaje de marcado de ClaimReview.

Campos
url

string

Es la URL desde la que se obtiene el lenguaje de marcado de ClaimReview. Habrá, como máximo, un resultado. Si el lenguaje de marcado está asociado con una versión más canónica de la URL proporcionada, devolveremos esa URL. No se puede especificar junto con una organización.
organization

string

Es la organización para la que queremos recuperar los marcadores. Por ejemplo, "site.com". No se puede especificar junto con una URL.
page_size

int32

Es el tamaño de la paginación. Devolveremos hasta esa cantidad de resultados. Si no se establece, el valor predeterminado es 10. No tiene efecto si se solicita una URL.
page_token

string

Es el token de paginación. Puedes proporcionar el next_page_token que se devolvió de una solicitud de List anterior, si existe, para obtener la página siguiente. Todos los demás campos deben tener los mismos valores que en la solicitud anterior.
offset

int32

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

ListClaimReviewMarkupPagesResponse

Es la respuesta del lenguaje de marcado ClaimReview del anuncio.

Campos
claim_review_markup_pages[]

ClaimReviewMarkupPage

Es la lista de páginas de resultados del lenguaje de marcado de ClaimReview.
next_page_token

string

Es el siguiente token de paginación en la respuesta de Search. Se debe usar como page_token para la siguiente solicitud. Un valor vacío significa que no hay más resultados.

Editor

Es información sobre el publicador.

Campos
name

string

Es el nombre de este publicador. Por ejemplo, "Awesome Fact Checks".
site

string

Nombre del sitio a nivel del host, sin el protocolo ni el prefijo "www". Por ejemplo, "awesomefactchecks.com". El valor de este campo se basa exclusivamente en la URL de revisión del reclamo.

UpdateClaimReviewMarkupPageRequest

Es una solicitud para actualizar todo el lenguaje de marcado ClaimReview en una página.

Campos
claim_review_markup_page

ClaimReviewMarkupPage

Es el lenguaje de marcado ClaimReview actualizado para esta página. Las solicitudes de actualización deben especificar el nombre del recurso y el ID de 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 (lo que puede ocurrir si el lenguaje de marcado se modificó desde la última lectura), se producirá un error en esta solicitud. 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 nueva URL.