versión API Graph

URL `/?id={url}`

Representa una URL que se ha compartido en una publicación o en un comentario de una publicación.

Consulta la documentación de la API de indexación de la pestaña “Noticias” para obtener información adicional.

Lectura

Obtén información sobre la URL que se compartió en una publicación o en un comentario de una publicación.

Requisitos

Tipo	Descripción
Identificadores de acceso	Se puede utilizar cualquier identificador de acceso para realizar esta solicitud.
Funciones	No es aplicable.
Tareas de página	No es aplicable.
Permisos	No es aplicable.

Limitaciones

Los valores de interacción devueltos no son precisos, pero sí reflejan la interacción de los usuarios con una URL.
Se aplica un límite de 10 solicitudes GET por URL, por aplicación, por hora.

Parámetros

Incluye los siguientes parámetros de la cadena de consulta para ampliar la solicitud.

Parámetro	Descripción
`access_token` Obligatorio Cadena	Identificador de acceso.
`fields` Cadena	Lista separada por comas de los campos que quieres solicitar.
`id` Cadena	URL que se va a compartir.
`scopes` Cadena	Lista separada por comas de los ámbitos.

Campos

Nombre de la propiedad	Descripción	Tipo
`app_links`	Los datos de AppLinks asociados con la URL, en caso de estar disponibles.	`AppLinks`
`id`	Dirección URL.	`string`
`engagement`	Recuentos de las distintas formas en que las personas han interactuado con la URL. Ten en cuenta que los valores de interacción no son precisos de forma intencionada, pero puedes confiar en que reflejan adecuadamente la interacción de los usuarios con una URL.	`object`
`comment_count`	Número de comentarios sobre la URL.	`int`
`comment_plugin_count`	Número de comentarios en el plugin recopilados con el plugin de comentarios en el sitio.	`int`
`reaction_count`	Número de reacciones a la URL.	`int`
`share_count`	Número de veces que se ha compartido la URL.	`int`
`og_object`	Objeto de Open Graph asociado de forma canónica a esta URL.	`OGObject`
`id`	Identificador del objeto.	`string`
`description`	Descripción del objeto, si está disponible.	`string`
`title`	Título del objeto, si está disponible.	`string`
`type`	Tipo de objeto.	`og:type`
`updated_time`	Indica cuándo se ha actualizado el objeto por última vez.	`datetime`

Ejemplos

Para obtener información sobre una URL publicada en una publicación o en un comentario, envía una solicitud GET a https://graph.facebook.com con el parámetro id establecido en la URL, cualquier campo sobre la URL y un identificador de acceso solicitado al usuario o la página que hizo la publicación o el comentario.

El siguiente ejemplo muestra la interacción para la URL (https://www.facebook.com) que compartió el usuario representado por el identificador de acceso de usuario.

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X GET \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com
    &fields=engagement
    &access_token={user-access-token}"

Si la solicitud se realiza correctamente, la aplicación recibe la siguiente información sobre la interacción para la URL compartida:

{
  "engagement": {
    "reaction_count": 514919172,
    "comment_count": 68687082,
    "share_count": 975739682,
    "comment_plugin_count": 1641
  },
  "id": "https://www.facebook.com"
}

Creación

Esta operación no se puede realizar en este extremo.

Actualización

Actualiza una URL.

Requisitos

Tipo	Descripción
Identificadores de acceso	Se puede utilizar cualquier identificador de acceso para realizar esta solicitud.
Funciones	No es aplicable.
Tareas de página	No es aplicable.
Permisos	No es aplicable.

Ejemplos

Para actualizar la información sobre una URL publicada en una publicación o en un comentario, envía una solicitud POST a https://graph.facebook.com con el parámetro id establecido en la URL, el parámetro scrape establecido en true, cualquier valor de fields sobre la URL y un identificador de acceso solicitado al usuario o página que hizo la publicación o el comentario.

El siguiente ejemplo actualiza la URL https://www.facebook.com/my-update que compartió el usuario representado por el identificador de acceso de usuario.

Se ha aplicado formato para mejorar la legibilidad.

curl -i -X POST \
 "https://graph.facebook.com/{latest-graph-api-version}/
    ?id=https://www.facebook.com/my-update
    &scrape=true
    &access_token={user-access-token}"

Si la solicitud se realiza correctamente, la aplicación recibe la siguiente información sobre la interacción para la URL compartida:

{
  "success": true
}

Parámetros de la cadena de consulta

Incluye los siguientes parámetros de la cadena de consulta para ampliar la solicitud.

Parámetro	Descripción
`access_token` Obligatorio Cadena	Identificador de acceso.
`fields` Cadena	Lista separada por comas de los campos que quieres solicitar.
`id` Obligatorio Cadena	URL que se va a actualizar. La URL se debe codificar, de forma que no interfiera con el parámetro `scrape`.
`scrape` Obligatorio Booleano	El valor debe ser `true`.

Ejemplo de solicitud

POST /{version}/?id={url}&scrape=true
Host: graph.facebook.com

Ejemplo de respuesta

{
  "success": true
}

Eliminación

Esta operación no se puede realizar en este extremo.

URL /?id={url}

Lectura

Requisitos

Limitaciones

Parámetros

Campos

Ejemplos

Creación

Actualización

Requisitos

Ejemplos

Parámetros de la cadena de consulta

Ejemplo de solicitud

Ejemplo de respuesta

Eliminación

URL `/?id={url}`