Voltar para Notícias para desenvolvedores

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

23 de fevereiro de 2021PorKirk Thaker

Lançamos hoje a versão 10.0 da Graph API e da API de Marketing do Facebook.

Este lançamento apresenta muitos anúncios, atualizações, descontinuações e reversões de descontinuação que podem afetar o modo como os seus aplicativos se integram à nossa plataforma. Esta publicação descreve as atualizações e as etapas que os desenvolvedores precisam seguir para evitar interrupções, conforme aplicável.

Veja abaixo informações detalhadas sobre todas as alterações. Para especificações técnicas, consulte o registro de alterações da versão 10.0.

Visite a Central de Iniciativas da Plataforma para saber mais sobre a Plataforma do Desenvolvedor.

Anúncios e atualizações

Certificação da Verificação de Uso de Dados

Para não perder o acesso à API da plataforma do Facebook, conclua a DUC (Verificação de Uso de Dados) em até 60 dias a partir da data de inscrição. Para concluir a DUC, acesse a página “Meus aplicativos” no Painel de Aplicativos.

No ano passado, o Facebook lançou a Verificação de Uso de Dados, um novo requisito anual para que os desenvolvedores possam garantir que o acesso à API e o uso de dados estejam em conformidade com os Termos da Plataforma e as Políticas do Desenvolvedor do Facebook.

Como parte de nosso lançamento gradual para todos os aplicativos, você receberá um prazo e mais informações por meio de um alerta do desenvolvedor. Um email será enviado para o endereço de contato registrado, e você receberá uma notificação na lista Ações necessárias no Painel de Aplicativos.

Para instruções detalhadas sobre como concluir a DUC, consulte nossa documentação do desenvolvedor. Você encontra mais informações na seção Perguntas frequentes dedicada à DUC.

Limites de dados e níveis de acesso a dados de 90 dias da API de Grupos:

A partir de 24 de maio de 2021, durante a utilização da API de Grupos, o período de acesso aos dados disponíveis dos aplicativos será limitada a 90 dias.

Apresentamos o acesso em níveis à API de Grupos para aplicativos de consumidor com base no modo dos aplicativos: publicado ou de desenvolvimento. As permissões da API de Grupos agora terão um comportamento semelhante ao acesso padrão ou avançado dos aplicativos de empresa.

Atualmente, os aplicativos no modo de desenvolvimento podem acessar todos os conteúdos de grupos públicos e privados quando o desenvolvedor é um administrador. Após concluir a análise, esses aplicativos podem acessar todo o conteúdo de grupos que instalaram o aplicativo.

Em 24 de maio de 2021, os aplicativos no modo de desenvolvimento poderão acessar somente o próprio conteúdo em grupos públicos e privados quando o desenvolvedor for um administrador. Isso significa que o aplicativo não terá acesso ao conteúdo publicado por usuários de outros grupos (sem função no aplicativo), como publicações e comentários.

Saiba mais no registro de alterações da versão 10.0

Níveis de acesso para as permissões de email e public_profile para aplicativos de empresa.

Como parte de nossas iniciativas contínuas para proteger dados de usuário, adicionamos permissões de public_profile (ou seja, campos de perfil público padrão) e de email ao modelo de níveis de acesso que anunciamos com a versão 8.0 da Graph para aplicativos de empresa atuais e novos.

Os aplicativos de empresa criados recentemente agora iniciam com o acesso padrão para permissões de public_profile e de email. Quando um aplicativo tem acesso padrão a public_profile, somente os usuários com uma função no aplicativo ou na empresa que o obteve podem pesquisar ou fazer login no aplicativo. Se você precisar que usuários externos façam login no aplicativo, os administradores poderão solicitar acesso avançado no Painel de Aplicativos. O acesso será concedido automaticamente.

Saiba mais no registro de alterações da versão 10.0

Lembretes para solicitações de exclusão de dados

Conforme anunciamos em 10 de novembro de 2020, aplicativos do tipo Consumidor e Jogos enviados para análise do aplicativo ou em transição do modo de desenvolvimento para o modo publicado precisarão fornecer um retorno de chamada de solicitação de exclusão de dados ou uma URL com instruções explícitas para usuários sobre como solicitar a exclusão de dados. Planejamos impor esse requisito até 10 de novembro de 2022. Além disso, enviaremos um lembrete aos desenvolvedores 60 dias antes da aplicação.

Opções de alteração ao AdsInsight da Graph API para o projeto de redução da retenção

A interface do usuário do Gerenciador de Anúncios não fornecerá mais suporte a relatórios de dados das métricas das informações de anúncios mais antigos que 37 meses. A API retornará um erro quando a solicitação tiver intervalos de datas com mais de 37 meses de retenção. Estamos desativando o 'date_preset = lifetime' e o substituindo por 'date_preset = maximum'.

As alterações na versão 10.0 da Graph API para o AdsInsight, com exceção de 'date_preset = lifetime', serão aplicadas a todas as outras versões após 90 dias. O campo específico chamado não precisa ser alterado. Haverá uma funcionalidade de predefinição, e todas as chamadas vitalícias terão como padrão o máximo de 37 meses de retenção.

Essa alteração não afetará dados relacionados a criativos do anúncio, públicos, configurações de veiculação ou nomes de objeto de anúncio. Além disso, não haverá alterações no cálculo de métricas existentes. Essa alteração será aplicada em plataformas de relatório de anúncios, incluindo o Gerenciador de Anúncios, o Relatórios de Anúncios e as experiências de anúncios leves.

  • Dia do lançamento 23/02/2021:
    • Versão 10.0
      • Ativar 'date_preset = maximum'
      • Desativar 'date_preset = lifetime'
      • Retornar erro quando a solicitação tiver intervalos de datas explícitos com mais de 37 meses de retenção
    • Versões 9.0 e inferiores
      • Nenhuma alteração à funcionalidade atual
  • 90 dias após o lançamento – 24/05/2021:
    • Versões 9.0 e inferiores
      • Ativar 'date_preset = maximum' (igual à nova versão)
      • Retornar erro quando a solicitação tiver intervalos de datas explícitos com mais de 37 meses de retenção (igual à nova versão)
      • 'date_preset = lifetime' ainda funciona, mas apenas retorna dados de até 37 meses, ou seja, se comporta como máximo

Saiba mais no registro de alterações da versão 10.0

Nova política de exclusão para dados de propriedade externa no ThreatExchange

A partir de 24 de maio de 2021, quando os parceiros definirem expire_time nos dados que carregarem para o ThreatExchange, excluiremos definitivamente os dados na data de validade mencionada. Se você quiser indicar que os dados não são mais válidos, configure o campo “expired_on” para fazer a exclusão automaticamente.

No passado, a exclusão temporária significava que marcávamos o conteúdo expirado como tal. Não oferecemos mais suporte a exclusões temporárias. Depois que o conteúdo expirar, ele será excluído definitivamente e não poderá mais ser visualizado no ThreatExchange.

Além disso, todos os ThreatDescriptors no ThreatExchange que não sejam do Facebook serão excluídos de maneira definitiva assim que expirarem. A data de validade continuará sendo definida pelo criador do ThreatDescriptor. A exclusão iniciará em todos os ThreatDescriptors expirados que não tiverem sido criados pelo Facebook. Caso o seu aplicativo tenha ThreatDescriptors expirados que você não queira excluir quando essa política entrar em vigor, será preciso adiar a data de validade ou defini-la como “0” para garantir que os dados nunca expirem.

Clique aqui para saber mais sobre as alterações

Alterações de direcionamento na nova API

Em 24 de maio de 2021, não solicitaremos mais os parâmetros de location_spec e país no momento de criação de um Público Personalizado Semelhante em todas as versões da API.

Ao criar o Público Semelhante, o usuário seleciona a origem semelhante e a proporção desejada. A localização para Semelhantes será definida pelo país nas especificações de direcionamento da campanha. A alteração não será aplicada a campanhas existentes. Essa alteração afetará somente campanhas novas e editadas.

Apresentação da nova plataforma da página de status publicado

A nova página de status de empresas no Facebook aumentará a transparência e a comunicação proativa com desenvolvedores externos que usam os produtos da plataforma do Facebook. Nessa página poderão ser centralizadas as verificações de status da plataforma dos produtos do Facebook para empresas (Anúncios, WhatsApp Business API, Plataforma do Desenvolvedor do Facebook etc.). Atualmente a página está publicada para o Gerenciador de Anúncios e a WhatsApp Business API. Outros produtos para empresas serão adicionados em maio de 2021.

Descontinuação

Descontinuação do diálogo Transmitir ao vivo

Em 24 de maio de 2021, descontinuaremos o SDK do diálogo Transmitir ao vivo. Essa descontinuação de uma ferramenta antiga para produção publicada ocorrerá em todas as versões da API. Essa alteração afetará somente transmissões ao vivo no Facebook. Incentivamos que os desenvolvedores usem o Live Producer e a Live API para todas as soluções de produção publicada sob medida.

Soluções para fazer transmissões ao vivo assim que o SDK do diálogo Transmitir ao vivo for descontinuado:

  • Acesse o Live Producer diretamente via facebook.com/live/producer (ou outros pontos de entrada no Facebook, como o botão “Vídeo ao vivo” em uma Página ou perfil).
  • Integre soluções personalizadas à Live API.

Saiba mais no registro de alterações da versão 10.0

Descontinuação do direcionamento para conexões

Em 24 de maio de 2021, o direcionamento para conexões não receberá mais suporte no momento de criação/edição de um conjunto de anúncios. Esse requisito terá impacto somente em campanhas novas e editadas e não afetará campanhas existentes.

Saiba mais no registro de alterações da versão 10.0

Reversões de descontinuação

Reverter a descontinuação do ponto de extremidade gr:delete:Page/tabs

Quando lançamos a versão 8.0 da Graph API, descontinuamos o ponto de extremidade gr:delete:Page/tabs para abas de Páginas. Decidimos reverter a descontinuação desse ponto de extremidade imediatamente para a versão 10.0 da Graph API e restabeleceremos o acesso a ele em 24 de maio de 2021 para todas as outras versões.

Saiba mais no registro de alterações da versão 10.0

Descontinuar os pontos de extremidade gr:post:Business/business_users, gr:post:Business/system_users e gr:post:User/access_tokens

Quando lançamos a versão 9.0 da Graph API, restringimos o acesso a três pontos de extremidade de empresa:

  • gr:post:Business/business_users
  • gr:post:Business/system_users
  • gr:post:User/access_tokens

Com o lançamento da Graph v10.0, reabriremos esses pontos de extremidade para chamadas de API quando o aplicativo atender a uma das condições a seguir:

  • A empresa-alvo é proprietária do aplicativo que está fazendo a chamada
  • A empresa de destino é derivada (em um modelo de dois níveis) da organização proprietária do aplicativo que está fazendo a chamada

Saiba mais no registro de alterações da versão 10.0

Calendário de itens de ação

Descontinuações de versão da API de Marketing:

Como parte de nossa programação de versões da API de Marketing, estas são as próximas descontinuações de versão da API de Marketing:

  • 3 de março de 2021: A versão 7.0 da API de Marketing será descontinuada e removida da plataforma
  • 4 de maio de 2021: A versão 8.0 da API de Marketing será descontinuada e removida da plataforma
  • 25 de agosto de 2021: A versão 9.0 da API de Marketing 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 de Marketing que lançamos hoje. (Consulte o registro de alterações para ver mais informações).

Descontinuações de versão da Graph API:

Como parte de nossa programação de versões da Graph API, observe as próximas descontinuações de versão listadas abaixo:

  • 4 de maio de 2021: A versão 3.2 da Graph API será descontinuada e removida da plataforma
  • 3 de agosto de 2021: A versão 3.3 da Graph API será descontinuada e removida da plataforma

Descontinuações gerais

  • 24 de maio de 2021:
    • O diálogo Transmitir ao vivo será descontinuado e removido da plataforma
    • O direcionamento para conexões será descontinuado e removido da plataforma

Ações que devem ser tomadas pelo desenvolvedor

  • Inscrição em andamento: Certificação da Verificação de Uso de Dados
    • Após a inscrição, é necessário concluir o processo em até 60 dias.
    • A seção Perguntas frequentes dedicada à DUC.
  • 23 de fevereiro de 2021: Lançamento de alterações na API de Graph AdsInsight somente para a versão 10.0 do Graph
  • 24 de maio de 2021:
    • Lançamento de alterações na API de Graph AdsInsight para as versões 9.0 e inferiores do Graph
    • Entram em vigor as alterações nos níveis de acesso com base na análise do aplicativo
      • Acesso a dados da API de Grupos limitado a 90 dias
      • Níveis de dados implementados da API de Grupos
      • Entram em vigor as alterações nas permissões de email e de public_profile para aplicativos de empresa
    • A nova política de dados de “exclusão definitiva” é implementada no ThreatExchange
  • 10 de novembro de 2022: Prazo final para solicitações de exclusão de dados