Uso de objetos

Temas relacionados

Facebook te permite publicar historias atractivas y estructuradas desde tu aplicación mediante una API fuertemente tipada que consta de objetos y acciones. Los objetos son los "nombres" o los destinos de las acciones que realizan las personas en tu aplicación.

El marcado HTML de Open Graph define los objetos en las páginas web.

Creación de objetos

Para crear los objetos, se deben añadir etiquetas de Meta de Open Graph en la página donde se hospeda el contenido.

Estas son las etiquetas básicas necesarias para convertir tu página en un objeto. Añádelas al <head> del HTML de la página.

<meta property="fb:app_id"          content="1234567890" /> 
<meta property="og:type"            content="article" /> 
<meta property="og:url"             content="http://newsblog.org/news/136756249803614" /> 
<meta property="og:title"           content="Introducing our New Site" /> 
<meta property="og:image"           content="https://scontent-sea1-1.xx.fbcdn.net/hphotos-xap1/t39.2178-6/851565_496755187057665_544240989_n.jpg" /> 
<meta property="og:description"    content="http://samples.ogp.me/390580850990722" />

En algunas plataformas de hospedaje y desarrollo en las que se crea una página de objetos y, simultáneamente, se publica el objeto en Open Graph, es posible que aparezca un mensaje de error que indique que el objeto no existe. El motivo es una condición de carrera que se da en algunos sistemas. Te recomendamos comprobar que se crea la página de objetos antes de publicar una acción en Open Graph, o bien aplicar un pequeño retraso para compensar la demora en la replicación (por ejemplo, 15-30 segundos).

Pruebas

Para probar el marcado, pasa una URL por el depurador de contenido compartido. Como resultado, se mostrarán las etiquetas que ha extraído el rastreador, junto con cualquier error o advertencia.

Actualización de objetos

El rastreador de Facebook volverá a extraer (y, por tanto, actualizará) los objetos en los siguientes casos:

Cuando se introduzca la dirección URL en el depurador de contenido compartido
Cada 30 días tras la primera extracción
Cuando una aplicación active una extracción utilizando un extremo de API

Este extremo de la API Graph es, simplemente, una llamada a:

POST /?id={object-instance-id or object-url}&scrape=true

La respuesta de este extremo será un objeto JSON que contiene toda la información sobre el objeto que se ha extraído (devuelve los mismos datos que cuando se lee el identificador del objeto en la API Graph).

El parámetro id puede ser la dirección URL canónica del objeto o bien el identificador de la instancia de objeto del gráfico.

Puedes editar en cualquier momento las propiedades de un objeto, con dos excepciones:

Título: una vez que se hayan asociado 50 acciones (Me gusta, comparticiones y comentarios) a un objeto, no podrás actualizar este título.
Tipo: una vez que se haya utilizado el objeto en una historia, no podrás cambiar el tipo de objeto. Consulta tipos de Open Graph para obtener más información.

Si quieres actualizar una imagen de un objeto, te recomendamos que la URL de la nueva imagen sea diferente de la original. El almacenamiento en caché puede impedir que se actualice la imagen.

Migración de páginas y cambio de URL

Si mueves una página a una nueva URL, puedes utilizar la URL antigua como origen canónico de la nueva y mantener los Me gusta, los comentarios y las veces que se ha compartido el objeto. Descubre cómo en nuestra guía para compartir para administradores web.