Diálogo do feed

Adicione o diálogo do feed ao aplicativo para que as pessoas possam publicar stories individuais com comentários nas próprias linhas do tempo.

O compartilhamento de stories pelo diálogo do feed não exige permissões adicionais.

Integração

Este diálogo pode ser usado com o Facebook SDK for Javascript, o SDK do Facebook para iOS e Android, bem como no redirecionamento total para uma URL. Estes são alguns exemplos de trechos de código usados para acionar o diálogo.

JavaScript

Para acionar o diálogo do feed, chame a função FB.ui e use o valor feed no parâmetro method.

FB.ui({
  method: 'feed',
  link: 'https://developers.facebook.com/docs/'
}, function(response){});

iOS

Leia o guia sobre o diálogo de compartilhamento do iOS, que também permite fazer publicações de Open Graph.

Android

Leia sobre o diálogo de compartilhamento do Android, que também permite fazer publicações de Open Graph.

Redirecionamento de URL

https://www.facebook.com/dialog/feed?
  app_id=145634995501895
  &display=popup
  &link=https%3A%2F%2Fdevelopers.facebook.com%2Fdocs%2F
  &redirect_uri=https://developers.facebook.com/tools/explorer

Observação

Se uma pessoa tiver a configuração "Quem pode publicar na sua linha do tempo?" definida como "Somente eu" e outra pessoa tentar publicar usando o diálogo do feed, o erro "Não é possível publicar" será exibido.

Parâmetros

Observação: se o aplicativo compartilha links do iTunes, do Google Play ou de um perfil ou uma página do Facebook, não publicamos imagens ou descrições especificadas com os parâmetros abaixo nos compartilhamentos. Em vez disso, publicamos algumas informações do aplicativo extraídas diretamente da App Store ou da página do Facebook com o Webcrawler. Talvez isso não inclua imagens. Para ver uma prévia do compartilhamento de link do iTunes ou do Google Play, insira a URL no Depurador de Compartilhamento.

Parâmetro Descrição

app_id

O identificador único do aplicativo. Obrigatório.

redirect_uri

A URL do destino de redirecionamento após o clique em um botão do diálogo. Parâmetro obrigatório ao usar redirecionamento de URL.

display

Determina como o diálogo foi renderizado.

  • Caso a implementação do diálogo de redirecionamento de URL esteja sendo usada, o resultado será uma exibição de página inteira em Facebook.com. Esse tipo de exibição é chamado de page.
  • Se você acionar o diálogo via SDK do Facebook para iOS ou para Android, isso será especificado automaticamente, levando à escolha de um tipo de exibição adequado ao dispositivo.
  • Caso você use o Facebook SDK for Javascript, o padrão será um tipo de iframe modal para as pessoas conectadas ao aplicativo, async para usos dentro de um jogo em Facebook.com e uma janela popup para todos os outros casos. Se necessário, também é possível forçar os tipos popup ou page ao usar o Facebook SDK for Javascript.
  • Para aplicativos web móvel, o tipo de exibição touch sempre será o padrão.

from

A identificação da pessoa que publica a mensagem. Se não estiver especificada, será a pessoa atual por padrão. Se estiver especificada, deve ser a identificação da pessoa ou da página administrada por ela.

to

A identificação do perfil no qual o story será publicado. Se não estiver especificada, o padrão será o valor from. A identificação deve pertencer a um amigo que também use o aplicativo.

link

O link anexado à publicação.

source

A URL de um arquivo de mídia (SWF ou MP3) anexado à publicação. Se for SWF, é necessário especificar picture para fornecer uma miniatura de vídeo.

ref

O argumento é uma lista separada por vírgulas formada por no máximo 5 itens distintos, cada um com no mínimo 1 e no máximo 15 caracteres do conjunto '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz_'. Cada categoria é usada nos Insights do Facebook para ajudar a medir o desempenho de diferentes tipos de publicações.

Parâmetros obsoletos

Parâmetro Descrição

post_id

A identificação do story publicado quando a pessoa escolhe publicar na própria linha do tempo.

properties

Um objeto JSON de pares chave-valor que aparecem no anexo do streaming abaixo da descrição com uma propriedade por linha. As chaves precisam ser strings, e os valores podem ser strings ou objetos JSON com chaves text e href.

actions

Uma matriz JSON com um único objeto descrevendo o link de ação que aparecerá ao lado dos links "Comentar" e "Curtir" abaixo da publicação. O objeto precisa ter as chaves name e link.

picture

A URL de uma imagem anexada à publicação. A imagem precisa ter pelo menos 200 x 200 pixels. Veja a documentação sobre as melhores práticas de compartilhamento para mais informações sobre tamanhos.

name

O nome do anexo do link.

caption

A legenda do link (aparece abaixo do nome do link). Se não estiver especificado, o campo será preenchido automaticamente com a URL do link.

description

A descrição do link (aparece abaixo da legenda do link). Se não estiver especificado, o campo será preenchido automaticamente com as informações extraídas do link, que é normalmente o título da página.

thumbnail

O arquivo de imagem local carregado, .jpg, .jpeg,.gif ou .png.