Usar objetos

Temas relacionados

Facebook te permite publicar historias atractivas y estructuradas desde tu app mediante una API estrictamente verificada que consta de objetos y acciones. Los objetos son los "sustantivos" o los destinos de las acciones que realizan los usuarios en tu app.

Los objetos se definen mediante marcado HTML de Open Graph en las páginas web.

Crear objetos

Los objetos se crean agregando metaetiquetas de Open Graph a la página en la que está alojado tu contenido.

Estas son las etiquetas básicas necesarias para convertir tu página en un objeto. Agrégalas al elemento <head> del HTML de tu 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 alojamiento 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 cree la página de objetos antes de publicar una acción en Open Graph o bien aplicar un pequeño retraso para compensar el retraso en la replicación (por ejemplo, 15-30 segundos).

Pruebas

Para probar tu marcado, pasa una URL a través del depurador de contenido compartido. Como resultado, se mostrarán las etiquetas que extrajo el rastreador, junto con los errores o las advertencias.

Actualizar objetos

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

Cuando se ingrese la URL del objeto en el depurador de contenido compartido
Cada 30 días tras la primera extracción
Cuando una app desencadene una extracción al utilizar un punto de conexión de API

Este punto de conexión de la API Graph es simplemente una llamada a:

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

La respuesta de este punto de conexión será un objeto JSON con toda la información sobre el objeto que se extrajo (los mismos datos devueltos cuando se lee el identificador del objeto en la API Graph).

El parámetro id puede ser la URL canónica de tu objeto o el identificador de la instancia del objeto en el 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 a un objeto (Me gusta, veces que se compartió y comentarios), no podrás actualizar su título.
Tipo: una vez que se haya utilizado un objeto en una historia, no es posible cambiar su tipo. Para obtener más información, consulta los tipos de Open Graph.

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.

Migrar páginas y cambiar direcciones 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 compartió el objeto. Obtén información sobre cómo hacerlo en nuestra guía para webmasters sobre el contenido compartido.