Versão 10.0

Graph API

Lançada em 23 de fevereiro de 2021 | Disponível até 8 de junho de 2023 | Publicação de blog

Apps de negócios

Níveis de acesso

Aplica-se a todos os apps criados após 16 de fevereiro de 2021.

Todos os apps de negócios criados após 16 de fevereiro de 2021 receberão automaticamente acesso padrão às permissões email e public_profile.

Aplica-se a todos os apps existentes criados após 16 de fevereiro de 2021.

Todos os apps de negócios criados antes de 16 de fevereiro de 2021 receberão automaticamente acesso avançado às permissões email e public_profile. Para os apps que não usam email ou public_profile, o acesso relacionado a essas duas permissões será rebaixado para o nível padrão.

É possível atualizar os apps de negócios para que eles tenham acesso avançado às permissões email e public_profile sem precisar passar pela análise do app.

Grupos

Aplica-se à versão 10.0 e superiores. As alterações serão aplicadas a todas as versões em 25 de maio de 2021.

• Para manter a conformidade com as políticas de retenção de dados do Facebook, a API de Grupos incluirá apenas dados de consultas criadas nos últimos 90 dias. Os dados retornados dependem do nível de acesso ou do modo do app e de sua função nele.
• A API de Grupos agora usa um sistema de acesso à API em dois níveis, padrão e privilegiado, em vez de usar o modo de desenvolvimento e o modo publicado. O nível de acesso padrão permitirá que você obtenha dados apenas de usuários que tiverem uma função no seu app. Já com o nível privilegiado, você poderá coletar dados de todos os usuários do grupo em que o app está instalado.

Páginas

Ponto de extremidade restabelecido

Aplica-se à versão 10.0 e superiores. As alterações serão aplicadas a todas as versões em 25 de maio de 2021.

O ponto de extremidade DELETE /{page-id}/tabs, que tinha sido descontinuado na versão 8.0, foi restabelecido na versão 10.0. Em 25 de maio de 2021, essa alteração será aplicada a todas as versões.

ThreatExchange

Exclusão de dados expirados

As alterações serão aplicadas a todas as versões em 25 de maio de 2021.

Os dados carregados no ThreatExchange com expire_time diferente de zero serão excluídos permanentemente na data de validade indicada. Se você quiser excluir dados que não são mais válidos, precisará definir o campo expired_on como a data atual, assim eles serão excluídos imediatamente.

Além disso, todos os ThreatDescriptors que não forem do Facebook serão excluídos de maneira permanente assim que atingirem a data de validade definida pelo criador. Caso o seu aplicativo tenha ThreatDescriptors expirados que você não queira apagar, será preciso estender a data de validade ou defini-la como "0" para garantir que os dados nunca expirem.

URL

Aplica-se à versão 10.0 e superiores. As alterações serão aplicadas a todas as versões em 25 de maio de 2021.

Engajamento

• Por questões de privacidade, as contagens retornadas pela solicitação GET /?id={url}/engagement podem não corresponder às contagens brutas.
• As solicitações do campo GET /?id={url}/engagement para a mesma URL serão limitadas a 10 solicitações por hora.

API de Marketing

Lançada em 23 de fevereiro de 2021 | Disponível até 4 de outubro de 2021 | Publicação de blog

Conta de anúncios

Alterações no campo

Aplica-se à versão 10.0 e superiores. As alterações serão aplicadas a todas as versões em 25 de maio de 2021.

O campo agency_client_declaration do nó AdAccount agora exige privilégios de administrador para todas as operações.

API de Insights sobre Anúncios

Parâmetro date_preset atualizado

Aplica-se à versão 10.0 e superiores.

• O parâmetro lifetime (date_preset=lifetime) está desativado e foi substituído por date_preset=maximum, que pode ser usado para recuperar no máximo 37 meses de dados. A API retornará um erro quando os intervalos de datas das solicitações ultrapassarem a janela de 37 meses.
• Para versões 9.0 ou inferiores, não haverá alterações na funcionalidade até 25 de maio de 2021. Nessa data, o parâmetro date_preset=maximum será habilitado e chamadas de lifetime terão maximum como padrão, retornando apenas 37 meses de dados.

Empresas

Flexibilização de restrições anteriores de acesso ao ponto de extremidade

Aplica-se à versão 10 e superiores.

Na versão 9.0, o acesso ao ponto de extremidade abaixo era restrito. O acesso foi restaurado para todos os apps, mas agora eles podem fazer o direcionamento apenas para empresas (ou empresas derivadas delas) que os obtiveram:

• POST /<APP_SCOPED_SYSTEM_USER_ID>/access_tokens
• POST /{business-id}/business_users
• POST /{business-id}/system_users

Direcionamento

Direcionamento de conexões

As alterações serão aplicadas a todas as versões em 24 de maio de 2021.

Os pontos de extremidade a seguir não aceitarão mais o direcionamento de conexões durante a criação ou a edição de campanhas de anúncios:

• POST /<ad_account_id>/adsets
• POST /<adset_id>

Essa alteração não afetará campanhas existentes em veiculação.

Públicos semelhantes

Os parâmetros location_spec e country serão removidos da criação de público semelhante. A localização dos semelhantes será definida de acordo com o país informado na especificação de direcionamento da campanha.

A alteração não será aplicada a campanhas existentes. Somente campanhas novas e editadas serão afetadas pelo requisito.

Os campos e pontos de extremidade a seguir serão afetados:

• POST /<ad_account_id>/customaudiences
• POST /<ad_account_id>/adsets
• POST /<ad_account_id>/adaccounts?adaccounts=<SHARED_TO_AD_ACCOUNT_ID>
• GET /<ad_account_id>/reachestimate
• GET /<ad_account_id>/delivery_estimate
• GET /<ad_account_id>?fields=approximate_count
• GET /<ad_account_id>?fields=delivery_status
• GET /<ad_account_id>?fields=operation_status

Consulte Públicos semelhantes: próximas alterações de semelhantes para saber mais sobre essas atualizações.