API Graph versión

URL `/?id={url}`

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

Consulta el documento pestaña de noticias de la API de indexación para obtener más información.

Lectura

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

Requisitos

Tipo	Descripción
Tokens de acceso	Es posible usar cualquier token de acceso para realizar esta solicitud.
Funciones	No se aplica.
Tareas de la página	No se aplica.
Permisos	No se aplica.

Limitaciones

Los valores de interacción que se devuelven no son precisos, pero reflejan la interacción de los usuarios con una URL.
Tienes un límite de 10 solicitudes "GET" por URL, app y hora.

Parámetros

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

Parámetro	Descripción
`access_token` Obligatorio Cadena	Un token de acceso.
`fields` Cadena	Una lista separada por comas de los campos que quieres solicitar.
`id` Cadena	La URL que se compartirá.
`scopes` Cadena	Una lista separada por comas de los ámbitos.

Campos

Nombre de la propiedad	Descripción	Tipo
`app_links`	Datos de App Links vinculados con esta URL, si corresponde.	`AppLinks`
`id`	La URL.	`string`
`engagement`	Conteos de distintas formas en que las personas interactuaron con la URL. Ten en cuenta que los valores de interacción no son precisos a propósito, pero puedes estar tranquilo de que reflejan con exactitud la interacción del usuario con una URL.	`object`
`comment_count`	Cantidad de comentarios en la URL.	`int`
`comment_plugin_count`	Cantidad de comentarios en el plugin, recopilados mediante el plugin de comentarios de tu sitio.	`int`
`reaction_count`	Cantidad de reacciones a la URL.	`int`
`share_count`	Cantidad de veces que se compartió la URL.	`int`
`og_object`	El objeto de Open Graph asociado canónicamente con esta URL.	`OGObject`
`id`	Identificador del objeto.	`string`
`description`	La descripción del objeto, si está disponible.	`string`
`title`	El título del objeto, si está disponible.	`string`
`type`	El tipo de objeto.	`og:type`
`updated_time`	La fecha y la hora de la última actualización del objeto.	`datetime`

Ejemplos

Para obtener información sobre una URL compartida en una publicación o un comentario, envía una solicitud GET a https://graph.facebook.com con el parámetro id configurado para la URL, cualquier campo relacionado con la URL y un token de acceso solicitado por el usuario o la página que realizó la publicación o el comentario.

En el siguiente ejemplo, se muestra la interacción con la URL, https://www.facebook.com, que compartió el usuario representado por el token de acceso de usuario.

El formato se modificó para facilitar la lectura.

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 procesa con éxito, tu app recibe los siguientes conteos de interacción con la URL que se compartió:

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

Creación

No es posible realizar esta operación en este punto de conexión.

Actualización

Actualiza una URL.

Requisitos

Tipo	Descripción
Tokens de acceso	Es posible usar cualquier token de acceso para realizar esta solicitud.
Funciones	No se aplica.
Tareas de la página	No se aplica.
Permisos	No se aplica.

Ejemplos

Para actualizar información sobre una URL compartida en una publicación o un comentario, envía una solicitud POST a https://graph.facebook.com con el parámetro id configurado para la URL, el parámetro scrape configurado en true, cualquier otro campo fields relacionado con la URL y un token de acceso solicitado por el usuario o la página que realizó la publicación o el comentario.

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

El formato se modificó para facilitar la lectura.

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 procesa con éxito, tu app recibe los siguientes conteos de interacción con la URL que se compartió:

{
  "success": true
}

Parámetros de la cadena de consulta

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

Parámetro	Descripción
`access_token` Obligatorio Cadena	Un token de acceso.
`fields` Cadena	Una lista separada por comas de los campos que quieres solicitar.
`id` Obligatorio Cadena	La URL que se actualizará. Debe codificarse la URL a fin de 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

No es posible realizar esta operación en este punto de conexión.

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}`