Compartilhamento

Como usar objetos

Tópicos relacionados

O Facebook permite que você publique stories complexos e estruturados com o seu app usando uma API fortemente tipada que consiste em objetos e ações. Os objetos são os "sujeitos" ou alvos das ações feitas pelas pessoas no app.

Os objetos são definidos por uma Marcação do Open Graph nas páginas da web.

Como criar objetos

Os objetos são criados com a adição de metatags de Open Graph à página em que o conteúdo está hospedado.

Estas são as tags básicas exigidas para tornar a sua página um objeto. Adicione-as ao <head> no HTML da 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" />

Em algumas plataformas de hospedagem e desenvolvimento em que você cria uma página de objeto e publica o objeto no Open Graph simultaneamente, pode ocorrer um erro informando que o objeto não existe. Isso ocorre em função de uma condição de corrida existente em alguns sistemas. Recomendamos que você verifique se a página de objeto foi criada antes de publicar uma ação no Open Graph ou introduza na conta um pequeno intervalo para o atraso de replicação (por exemplo, de 15 a 30 segundos).


Teste

É possível testar a marcação passando uma URL pelo Depurador de Compartilhamento. Isso mostrará as tags que o rastreador buscou, além de erros ou avisos.

Como atualizar objetos

O rastreador do Facebook raspará novamente (e atualizará) os objetos:

  • Quando a URL do objeto for enviada ao Depurador de Compartilhamento
  • A cada 30 dias depois da primeira raspagem
  • Quando um app disparar uma raspagem usando um ponto de extremidade de API

O ponto de extremidade da Graph API é uma chamada para o seguinte:

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

A resposta do ponto de extremidade será um objeto JSON com todas as informações sobre o objeto extraído. Esses dados são os mesmos retornados quando a identificação do objeto é lida na Graph API.

O parâmetro id pode ser a URL canônica do objeto ou a identificação da instância de objeto no gráfico.

Você sempre pode editar as propriedades do objeto, com duas exceções:

  • Título: quando 50 ações (curtidas, compartilhamentos e comentários) forem associadas a um objeto, não será possível atualizar o título.
  • Tipo: o tipo do objeto não poderá ser alterado depois de ser usado em um story. Para ver mais informações, consulte os tipos de Open Graph.

Se você quiser atualizar uma imagem para um objeto, recomendamos que a URL para a imagem seja diferente da URL da imagem original. O armazenamento em cache pode impedir a atualização da imagem.

Como migrar páginas e alterar URLs

Se quiser mover uma página para uma nova URL, você poderá usar a URL antiga como origem canônica. Assim, as curtidas, os comentários e os compartilhamentos do objeto serão preservados. Saiba mais no guia de compartilhamento para webmasters.