v2.5 - Graph API - Documentação

Versão 2.5

Lançamento em 7 de outubro de 2015 | Disponível até 12 de abril de 2018

Esta versão expirou em 12 de abril de 2018. Use a Ferramenta de atualização de API para atualizar os apps antes dessa data. Saiba mais sobre como atualizar seus apps neste guia de atualização.

Permissões
- GET {user_id}/accounts agora exige manage_pages ou pages_show_list (a segunda opção é uma nova permissão na versão 2.5).
- POST {page_id}/call_to_actions e POST/DELETE {call-to-action-id} exigem a nova permissão pages_manage_cta que foi lançada na versão 2.5.

Gerenciamento de chamadas para ação: agora é possível gerenciar chamadas para ação em uma Página.
- GET page/call_to_actions ou GET {call-to-action-id} para ler a chamada para ação.
- POST page/call_to_actions para adicionar uma chamada para ação a uma Página.
- POST {call-to-action-id} para atualizar.
- DELETE {call-to-action-id} para excluir uma chamada para ação da Página.

Nó de local: o campo a seguir foi adicionado ao nó Place.
- overall_rating: fornece a classificação média com base nas avaliações públicas de um local.

Carregamento de vídeo: foram acrescentados os seguintes parâmetros.
- slideshow_spec: crie apresentações multimídia carregando imagens.
- secret: o vídeo publicado não aparecerá no Feed de Notícias, na linha do tempo nem na aba Vídeo da Página do Facebook. Além disso, ele não poderá ser pesquisado. Um vídeo só pode ser visualizado e compartilhado por meio de um link permanente. Somente para usuários da Página.
- social_actions: permita ou proíba o uso de ações sociais do Facebook como curtidas, comentários e compartilhamento em um vídeo oculto. Somente para usuários da Página.

Edição de vídeo: foram acrescentados os seguintes parâmetros.
- publish_to_videos_tab: distribua itens de vídeo publicamente na aba Vídeo da Página, mas não no Feed de Notícias nem na linha do tempo.
- publish_to_news_feed: distribua itens de vídeo publicamente no Feed de Notícias, na linha do tempo e na aba Vídeo da Página.

Ponto de extremidade de publicações marcadas: GET /{page-id}/tagged incluirá todas as publicações abertas em que a Página foi marcada. É preciso ter um token de acesso à Página com a permissão manage_pages.

GET /{user-id}?fields=address retorna um erro: o campo address, que estava disponível em versões anteriores e retornava um valor vazio, retornará um erro na versão 2.5.

Desabilitação automática das assinaturas: a partir de agora, desabilitaremos automaticamente as assinaturas de Webhooks se a URL de retorno de chamada falhar por 7 dias consecutivos. Será possível habilitá-la outra vez com uma solicitação POST para /subscriptions. Essa mudança não se aplica a assinaturas por pagamento.
Atualização de assinaturas existentes: as assinaturas de Webhooks existentes podem ser modificadas por meio da API de /subscriptions. POST /subscriptions fará a alteração da assinatura do tópico em questão sem alterar os campos atuais. Você pode excluir campos específicos da sua assinatura incluindo um parâmetro de campos ao chamar DELETE /subscriptions.

Formato de URI dos apps da aba de Página: o formato de URI dos apps da aba de Página https://www.facebook.com/{vanity}?v={app_id} não funcionará mais 90 dias após este lançamento. Use https://www.facebook.com/{vanity}?sk={app_id} ou https://www.facebook.com/{vanity}/{app_id}.

Novas atualizações em tempo real apenas via HTTPS: não é possível criar novas assinaturas com uma URL de retorno de chamada não HTTPS. Isso afeta as atualizações de User, Page, App e Payment.