Introducing Facebook Graph API v12.0 and Marketing API v12.0

Hoje estamos lançando a versão 12.0 da Graph API e da API de Marketing do Facebook. A seguir, destacamos mudanças que influenciarão parte da nossa comunidade de desenvolvedores. Entre elas, anúncios e atualizações de produtos, lembretes de lançamentos anteriores e notificações sobre descontinuações que podem afetar a integração do seu aplicativo à nossa plataforma.

Para ver a lista completa e detalhada das mudanças, consulte o registro de alterações.

Atualizações e anúncios gerais

API de Conversões: expansão da versão mínima chamável

Compatibilidade retroativa da Graph API com aplicativos criados com tokens de acesso de um clique: a partir da versão 12.0, os tokens de acesso recém-criados, gerados na aba de configurações da API de Conversões no Gerenciador de Eventos, são compatíveis com todas as versões disponíveis da Graph API (veja as versões compatíveis aqui).

Observe que as chamadas feitas com esses tokens para versões descontinuadas da Graph API resultarão na versão mais antiga disponível. Esse comportamento se aplica apenas a pontos de extremidade da Graph API. Os pontos de extremidade da API de Marketing, incluindo a API de Conversões, não são compatíveis com comportamentos de atualização automática e geram uma exceção.

API de Perfil de Usuário para Mensagens do Instagram: novos campos

Estamos aprimorando a API de Perfil de Usuário para Mensagens do Instagram. Ela era compatível com dois campos: 1) Nome e 2) URL da foto do perfil. A fim de possibilitar que as empresas personalizem e priorizem as mensagens com base nas informações de usuário disponíveis publicamente, atualizamos a API para incluir as seguintes informações:

1. Número de seguidores
2. Selo de verificação
3. A empresa segue a conta do usuário [Sim/Não]
4. A conta do usuário segue a conta empresarial [Sim/Não]

Para saber mais, consulte a documentação para desenvolvedores.

Novas oportunidades de direcionamento detalhado

A fim de ajudar os anunciantes a encontrar oportunidades que não estavam disponíveis originalmente, nós as incluiremos de maneira automática na expansão do direcionamento quando eles aproveitarem o direcionamento detalhado e o otimizarem para eventos do aplicativo, conversões ou valores usando o objetivo de conversões. Para saber mais, consulte o artigo da Central de Ajuda Sobre a expansão do direcionamento detalhado.

API de Vídeo: novos campos

Adicionamos dois novos campos, views e post_views, ao nó [Video]. Para saber mais, consulte a documentação para desenvolvedores sobre API de Vídeo.

Descontinuações e alterações disruptivas

Transparência de erro

O comportamento padrão da Graph API e da API de Marketing é emitir um erro quando o aplicativo solicita um campo ou uma borda em um nó que retorna um ou mais nós associados, mas não conta com as permissões apropriadas exigidas por eles. Contudo, vários desses campos e bordas não seguiam o protocolo e eram omitidos das respostas da API caso o aplicativo de chamada não tivesse as permissões adequadas.

A partir da versão 12.0, esses campos e essas bordas estarão em conformidade com o comportamento padrão. Essa alteração será aplicada a todas as versões em 13 de dezembro de 2021.

• Pontos de extremidade da Graph API afetados
• Pontos de extremidade da API de Marketing afetados

Usuários do sistema e funções do aplicativo

A habilidade do usuário do sistema de receber funções em aplicativos será descontinuada, a menos que usuário e aplicativo pertençam à mesma empresa. A fim de evitar a interrupção do aplicativo e dos negócios, recomendamos que usuários do sistema sejam removidos do aplicativo e usem a API de "empresa gerenciada em nome de". Essas alterações disruptivas entrarão em vigor no dia 13 de dezembro de 2021.

Ao vivo programado

Estamos descontinuando o parâmetro planned_start_time no recurso de programação na Live API, e a alteração disruptiva entrará em vigor em 13 de dezembro de 2021. Um novo parâmetro será anunciado futuramente.

Plataforma do Messenger: API de Conversa

Estamos descontinuando o campo user_id dos metadados de conversa na API de Conversa. Os desenvolvedores precisarão migrar as referências para o user_id (IGID) e o IGSID deverá ser o identificador primário de uma conversa entre usuário e empresa.

Essa alteração disruptiva entrará em vigor nas versões anteriores da Graph API em 13 de dezembro de 2021. Para saber mais, consulte a documentação para desenvolvedores sobre a API de Conversa.

Plataforma do Messenger: Webhooks do Instagram

Estamos atualizando nosso webhook de reação da API do Messenger para Instagram a fim de aceitar reações de emoji. A versão atual retorna o campo de emoji como uma string. Com essa atualização, os webhooks de reação retornarão um novo formato Unicode. Observe que o campo "reação" é compatível apenas com emojis padrão. Para todos os outros emojis, esse campo retornará "outros", assim como o MSGR.

Essa alteração disruptiva entrará em vigor nas versões anteriores da Graph API a partir de 13 de dezembro de 2021. Para continuar aceitando reações de emoji, os desenvolvedores devem migrar até 13 de dezembro de 2021 para o novo Unicode que estamos retornando. Para saber mais, consulte a documentação para desenvolvedores sobre Webhooks.

Descontinuações de versões de API:

Observe a programação para as próximas descontinuações de versões da Graph API e da API de Marketing:

Graph API

• 2 de novembro de 2021: a versão 4.0 da Graph API será descontinuada e removida da plataforma.
• 3 de fevereiro de 2022: a versão 5.0 da Graph API será descontinuada e removida da plataforma.
• 22 de maio de 2022: a versão 6.0 da Graph API será descontinuada e removida da plataforma.

Para evitar inconvenientes à sua empresa, recomendamos que você migre todas as chamadas para a versão mais recente da API lançada hoje.

API de Marketing

• A versão 10.0 da API de Marketing será descontinuada em 4 de outubro de 2021.
• A versão 11.0 da API de Marketing será descontinuada em 23 de fevereiro de 2022.

Para evitar inconvenientes à sua empresa, recomendamos que você migre todas as chamadas para a versão mais recente da API de Marketing lançada hoje. (Consulte o registro de alterações para mais informações).

SDK da plataforma do Facebook

• Em 19 de janeiro de 2021, anunciamos o cronograma de descontinuações de dois anos da versão 8.x e anteriores do SDK da plataforma do Facebook. Essas versões expirarão em janeiro de 2023.
• Em 8 de junho de 2021, lançamos a versão 11.0 do SDK da plataforma do Facebook, dando início à descontinuação da versão 9.0. A versão do SDK expirará em junho de 2023.

Descontinuações gerais

Descontinuações dos pontos de extremidade das ofertas nativas

Em 8 de junho de 2021, anunciamos a descontinuação da API de Anúncios de Oferta. Essa medida entrará em vigor imediatamente após o lançamento da versão 12.0 da Graph API.

Plataforma do Messenger: modelos para companhias aéreas

Em 8 de junho de 2021, anunciamos a descontinuação dos modelos para companhias aéreas. Essa medida entrará em vigor em 6 de dezembro de 2021.