Versão 7.0

Graph API

Lançada em 5 de maio de 2020 | Disponível até 4 de agosto de 2022 | Publicação de blog

Extensão do Facebook para Empresas 2.0

Esta alteração é aplicável a todas as versões.

Dois campos novos foram adicionados à versão 2.0 da Extensão do Facebook para Empresas.

• Identificação da conta de anúncios (ad_account_id): representa a identificação da conta de anúncios selecionada pelo usuário na FBE. A conta de anúncios pode ser usada para gerenciar anúncios caso o app tenha as permissões ads_management.

• ID do catálogo (catalog_id): o ID do catálogo selecionado pelo usuário na FBE. Ele pode ser usado para gerenciar o catálogo de produtos.

Instagram

Pesquisa de hashtag

Esta alteração é aplicável à versão 7.0 e superiores.

Agora é possível solicitar o campo timestamp na mídia do Instagram retornada pelas consultas da pesquisa de hashtag GET /{ig-hashtag-id}/top_media e GET /{ig-hashtag-id}/recent_media. Por exemplo: GET /{ig-hashtag-id}/top_media?fields=timestamp.

Messenger

Plugin de bate-papo com o cliente

Essa alteração é aplicável à versão 7.0 e superiores. Em 2 de novembro de 2020, ela será aplicada a todas as versões.

Quando você iniciar uma nova conversa ou continuar uma existente por meio do plugin de bate-papo do cliente, as notificações de webhook messaging_postbacks e messaging_referrals iniciais terão um ID anônimo user_ref para o usuário em vez do ID no escopo da Página (PSID). Assim que o usuário enviar uma mensagem, as notificações subsequentes do webhook terão o PSID do usuário.

Perfis de Página no Messenger

Esta alteração é aplicável à versão 7.0 e superiores.

A propriedade home_url em perfis de Página no Messenger ficou obsoleta em todas as operações (GET, POST e DELETE).

Open Graph

Itens que se tornaram obsoletos

Esta alteração é aplicável à versão 7.0 e superiores. Em 3 de agosto de 2020, ela será aplicada a todas as versões.

• GET /{open-graph-action-type-id}
• POST /{user-id}/{open-graph-action-type-id}

Páginas

IDs do usuário no escopo do app

Estas alterações são aplicáveis à versão 7.0 e superiores. Em 5 de maio de 2021, elas serão aplicadas a todas as versões.

No dia 1º de maio de 2018, a API de Páginas começou a retornar IDs do usuário no escopo da Página (PSID) em vez de IDs do usuário no escopo do app (ASID) para todos os apps novos. Os apps criados antes disso continuaram recebendo ASIDs, a menos que tenham optado por receber PSIDs. A partir de agora, todos os apps receberão PSIDs da API de Páginas.

A API de ID no escopo da Página permite que você faça a correspondência entre ASIDs e PSIDs. A API ficou obsoleta na versão 7.0 e posteriores. Entretanto, as versões mais antigas podem ser usadas até 5 de maio de 2021.

Itens que se tornaram obsoletos

Estas alterações são aplicáveis à versão 7.0 e superiores. Em 3 de agosto de 2020, elas serão aplicadas a todas as versões.

Os seguintes pontos de extremidade ficaram obsoletos:

• GET /{page-id}/featured_videos_collection
• POST /{page-id}/albums

Permissões

A permissão manage_pages ficou obsoleta e foi substituída por quatro novas permissões:

• pages_manage_ads
• pages_manage_metadata
• pages_read_engagement
• pages_read_user_content

A permissão publish_pages ficou obsoleta e foi substituída por duas novas permissões:

• pages_manage_posts
• pages_manage_engagement

Até 1º de junho de 2020, os apps aprovados para manage_pages, publish_pages ou ambas serão migrados para as novas permissões.

Para os apps que foram enviados, mas ainda não foram analisados para manage_pages, publish_pages ou ambas, o processo de análise continuará normalmente. Depois de aprovados, os apps serão migrados para as novas permissões até 1º de junho de 2020.

Caso você queira solicitar ou reenviar a solicitação das permissões para Páginas antes de 1º de junho de 2020, selecione as permissões no painel do app (manage_pages, publish_pages, ambas ou as novas permissões). O app será migrado automaticamente para as novas permissões até 1º de junho de 2020, se necessário.

Depois de 1º de junho de 2020, manage_pages e publish_pages não estarão mais disponíveis para seleção em Análise do aplicativo > Permissões e recursos no Painel de Aplicativos.

As permissões manage_pages e publish_pages ficarão obsoletas em maio de 2022. As alterações no código precisam ser aplicadas antes disso.

SDKs

Consulte o registro de alterações do SDK para iOS e do Android SDK para saber mais sobre as próximas alterações importantes.

Usuário

Itens que se tornaram obsoletos

Estas alterações são aplicáveis à versão 7.0 e superiores. Em 3 de agosto de 2020, elas serão aplicadas a todas as versões.

Os seguintes pontos de extremidade ficaram obsoletos:

• GET /{user-id}/books
• GET /{user-id}/games
• GET /{user-id}/movies
• GET /{user-id}/television

API de Marketing

Lançada em 5 de maio de 2020 | Disponível até 3 de março de 2021 | Publicação de blog

Campanhas de anúncio

Otimização do orçamento da campanha

Esta alteração é aplicável à versão 7.0 e superiores.

Para uma campanha específica de anúncios, você não poderá mais definir lifetime_budget e spend_cap ao mesmo tempo. Será possível selecionar somente lifetime_budget.

Um orçamento vitalício da campanha se distribui ao longo da sua campanha. Quando você usa lifetime_budget no nível da campanha, a informação do limite de gastos já está incluída. Portanto, não é preciso adicionar um segundo limite de gastos.

O spend_cap pode continuar sendo usado em campanhas sem otimização do orçamento.

Categoria de anúncio especial

Esta alteração é aplicável à versão 7.0 e superiores.

No ponto de extremidade POST /act_<AD_ACCOUNT_ID>/campaigns, o parâmetro special_ad_category ficou obsoleto e foi substituído por um novo parâmetro special_ad_categories.

O novo parâmetro special_ad_categories é obrigatório e aceita uma matriz. Caso você obtenha o parâmetro special_ad_category, ele ainda retornará uma string, mas é preciso usar GET /{campaign-id}?fields=special_ad_categories para receber uma matriz.

Para ver mais informações, consulte Categorias de anúncio especial.

Saiba mais sobre Como escolher uma categoria de anúncio especial na Central de Ajuda de Anúncios.

Itens que se tornaram obsoletos

Esta alteração é aplicável à versão 7.0 e superiores.

O parâmetro budget_rebalance_flag ficou obsoleto. Como alternativa, recomendamos o uso da otimização do orçamento da campanha.

Campanhas de anúncios Atlas

Itens que se tornaram obsoletos

Esta alteração é aplicável à versão 7.0 e superiores.

• GET /{atlas-ad-campaign-id}/cumulative_edited_date

Catálogo de produtos

Itens que se tornaram obsoletos

Esta alteração é aplicável à versão 7.0 e superiores.

Na borda POST /PRODUCT_CATALOG_ID, o parâmetro cpas_parent_catalog_settings ficou obsoleto para apps de terceiros.