Versão 11.0

Graph API

Lançada em 8 de junho de 2021 | Disponível até 14 de setembro de 2023 | Post de blog

Apps para o consumidor

Níveis de acesso

Aplicável a todas as versões.

Nas próximas semanas, os níveis de acesso serão aplicados a todos os aplicativos do tipo Consumidor. Nesses apps, as permissões e os recursos já aprovados pelo processo de Análise do App serão aprovados automaticamente para o Advanced Access. Todas as outras permissões e recursos serão aprovados automaticamente para o Acesso Padrão.

Os níveis de acesso também serão aplicados aos aplicativos recém-criados nas próximas semanas. Esses apps terão aprovação automática para o acesso avançado às permissões email e public_profile. No entanto, ambas as permissões terão o acesso padrão inicialmente. Será necessário definir o Advanced Access de forma manual para solicitar essas permissões de usuários sem função no app.

Suporte ao desenvolvedor

Lançamos a ferramenta de status do Facebook para Empresas para monitorar o estado da plataforma e dos produtos para empresas, como o Gerenciador de Anúncios, o WhatsApp Business e a Plataforma do Desenvolvedor do Facebook.

Facebook Analytics

Descontinuação

Aplicável a todas as versões.

A partir de 30 de junho de 2021, o Facebook Analytics não estará mais disponível. Além disso, o plugin do Painel de Aplicativos para a API de Marketing se tornará obsoleto. Para mais informações, consulte a Central de Ajuda para Empresas.

Os seguintes campos do nó "application" não estão mais disponíveis:

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Os seguintes pontos de extremidade não estão mais disponíveis:

GET Application/analytics_cohort_query
GET Application/analytics_entity_user_config
GET Application/analytics_event_types
GET Application/analytics_funnel_query
GET Application/analytics_query
GET Application/analytics_segments

API de Exibição Básica do Instagram

Depurador de Token de Acesso

Aplicável a todas as versões.

A ferramenta Depurador de Token de Acesso agora retorna apenas um ID no escopo do aplicativo ao depurar um token.

Controle de versões da API

Aplicável a todas as versões.

Agora a API aceita chamadas com controle de versão. Para consultar uma versão específica da API, inclua o número correspondente no caminho da consulta após a URL de base. Por exemplo:

https://graph.instagram.com/v11.0/{node-id}/{edge-name}

As solicitações sem controle de versão (número de versão ausente) consideram a versão especificada em Painel de Aplicativos > Configurações > Avançado > Atualizar a versão da API no aplicativo que faz a chamada.

ID do usuário no escopo do aplicativo

Aplicável a partir da versão 11.0.

Os IDs do usuário no escopo do aplicativo (ASIDs, pelas iniciais em inglês) foram lançados. Os ASIDs substituirão os IDs dos usuários brutos em aproximadamente dois anos, quando a versão 10.0 se tornar obsoleta. Por isso, recomendamos que você comece a mapear os IDs brutos dos usuários do aplicativo em relação aos ASIDs equivalentes.

Todas as versões aceitam consultas baseadas no ID bruto do usuário.
Somente as versões a partir da 11.0 aceitam consultas baseadas em ASID.
As chamadas da versão 11.0 e posteriores receberão ASIDs nas respostas, mesmo ao consultar números de identificação brutos do usuário.

Paginação com base no tempo

Aplicável a partir da versão 11.0.

Os parâmetros since e until foram adicionados ao ponto de extremidade GET /{user-id}/media para oferecer compatibilidade com a paginação com base no tempo.

Graph API do Instagram

Número de curtidas

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

Caso uma consulta indireta seja feita a uma mídia do Instagram por meio de outro ponto de extremidade ou expansão de campo, o campo like_count será omitido das respostas de API se o dono da mídia tiver ocultado o número de curtidas. A consulta direta a mídias do Instagram (que pode ser realizada somente pelo próprio dono) retornará o número real de curtidas mesmo se a contagem tiver sido ocultada.

Paginação com base no tempo

Aplicável a partir da versão 11.0.

Os parâmetros since e until foram adicionados ao ponto de extremidade GET /{ig-user-id}/media para compatibilidade com a paginação com base no tempo.

Experiências Instantâneas

Modelos

Aplicável a partir da versão 11.0.

Os modelos de experiência instantânea saíram da versão beta e agora estão disponíveis a todos os desenvolvedores.

Plataforma do Messenger

Webhook de postbacks de mensagens

Aplicável a partir da versão 11.0.

O campo mid foi adicionado ao webhook messaging_postbacks para que os apps possam obter a identificação da mensagem.

Descontinuação de modelos de companhias aéreas

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 6 de dezembro de 2021.

As chamadas a POST /{page-id}/messages que incluírem modelos de companhias aéreas (template_type dos tipos airline_boardingpass, airline_checkin, airline_itinerary e airline_update) resultarão em falhas.

oEmbed

Novo recurso oEmbed Read

Aplicável a todas as versões.

O produto oEmbed foi substituído pelo novo recurso oEmbed Read. Se tiver implementado o produto oEmbed antes de 8 de junho de 2021, você terá de concluir a Análise do App para o recurso oEmbed Read até 7 de setembro de 2021. Se você não tiver recebido a aprovação para o recurso oEmbed Read até 7 de setembro de 2021, as suas implementações oEmbed não serão carregadas.

API de Páginas

Identificações de comentário

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

O campo id de comentários não será retornado para os aplicativos que usarem o recurso de Acesso ao Conteúdo Público da Página somente para consultar pontos de extremidade de Páginas. Isso inclui os campos id/PAGEPOST-ID/comments ou /COMMENT-ID/comments. Para obter os campos id de comentários em publicações da Página, o usuário do aplicativo precisa executar a tarefa MODERATE na Página que está sendo consultada.

Nova experiência de Página

Nos próximos meses, todas as Páginas clássicas migrarão para a nova experiência de Página. Use o campo de Páginahas_transitioned_to_new_page_experience para verificar se a migração de uma Página já foi concluída. A experiência clássica deixará de ser disponibilizada após o término da migração de todas as Páginas.

A maioria dos pontos de extremidade da API de Páginas é compatível com as Páginas clássicas e com a nova experiência de Página (NPE, pelas iniciais em inglês). Os pontos de extremidade compatíveis com as Páginas da NPE têm uma seção "Nova experiência de Página" nas próprias referências.

Os pontos de extremidade a seguir não são compatíveis com páginas da NPE:

/PAGE-ID/likes
/PAGE-ID/global_brand_children
/PAGE-ID/locations
/PAGE-ID/tabs
/PAGE-ID/visitor_posts

Diversos campos de Página não estão disponíveis para a NPE. Ao receber chamadas, eles retornarão null, um conjunto de dados diferente ou um erro. Acesse a Visão geral da nova experiência de Página para ver uma lista desses campos.

Permissões

user_likes

Aplicável a todas as versões.

O uso permitido da permissão user_likes foi atualizado. A partir de 7 de setembro de 2021, revogaremos a aprovação dos apps que violarem a nova descrição de uso da permissão.

Uso permitido anterior: melhorar de maneira significativa a qualidade da experiência de um usuário no app (é preciso deixar claro para o usuário como os dados dele são usados para fornecer essa experiência).
Novo uso permitido: fornecer uma experiência personalizada ao correlacionar ou exibir conteúdo relacionado às curtidas da pessoa. Isso inclui selecionar conteúdo em escala para personalizar aplicativos com grande quantidade de conteúdo e permitir que as pessoas compartilhem as próprias curtidas com outros usuários, como no caso de aplicativos de encontros e de música.

user_posts

Aplicável a todas as versões.

O uso permitido da permissão user_posts foi atualizado. A partir de 7 de setembro de 2021, revogaremos a aprovação dos apps que já foram aprovados para essa permissão, mas que violarem a nova descrição de uso.

Uso permitido anterior: melhorar de maneira significativa a qualidade da experiência de um usuário no app (é preciso deixar claro para o usuário como os dados dele são usados para fornecer essa experiência).
Novo uso permitido: possibilitar que as pessoas criem livros ou álbuns (físicos ou digitais) e compartilhem lembranças da linha do tempo no Facebook ou em outros aplicativos sociais.

SDK

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

API de Marketing

Lançada em 8 de junho de 2021 | Disponível até 23 de fevereiro de 2022 | Post de blog

Públicos

Exclusão de públicos personalizados, públicos semelhantes e públicos salvos

Aplicável a todas as versões.

A partir de 8 de junho de 2021, qualquer público personalizado, semelhante ou salvo que não tenha sido usado em um conjunto de anúncios ativo há mais de dois anos será sinalizado como "Público prestes a expirar". A exclusão desse público será agendada para 90 dias depois do início dessa sinalização.

Os desenvolvedores poderão filtrar o status "Público prestes a expirar" com o campo operation_status para consultar a hora de exclusão estimada do público no sistema por meio do campo delete_time. Os desenvolvedores podem optar por excluir o público de forma proativa ou utilizá-lo em um conjunto de anúncios ativo para evitar a exclusão. Não será possível reativar o público após a exclusão.

Para públicos personalizados (exceto públicos personalizados da lista de clientes), semelhantes ou salvos:

Caso os anunciantes concordem com a exclusão automática dos públicos sinalizados a partir de 6 de setembro de 2021, nenhuma ação será necessária. Porém, se quiserem, os anunciantes também podem excluir o público proativamente antes da data de exclusão automática.
Se os anunciantes quiserem evitar a exclusão de um público sinalizado, será necessário usá-lo em um conjunto de anúncios ativo antes de 6 de setembro de 2021.

Para Públicos Personalizados da lista de clientes:

Armazenamos esse tipo de público em nome dos anunciantes e de acordo com as instruções deles. Caso os anunciantes não usem os públicos sinalizados em um conjunto de anúncios ativo até 6 de setembro de 2021, consideraremos isso como uma instrução para deletá-los.

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

GET /{custom-audience-id}
GET /act_{ad-account-id}/customaudiences?filtering
GET /act_{ad-account-id}/saved_audiences?filtering
GET /{saved-audience-id}

Consulte Visão geral dos públicos: alterações na exclusão de Públicos Personalizados para ver mais detalhes sobre as atualizações.

Business API

Aplicável a todas as versões.

O acesso aos pontos de extremidade a seguir será limitado de forma temporária. Somente os aplicativos com chamadas bem-sucedidas a esses pontos de extremidade nos últimos 30 dias continuarão tendo acesso.

Todos os outros aplicativos receberão um erro ao fazer chamadas a esses pontos de extremidade.

API de Catálogo

Descontinuação do campo de inventário de produtos

Aplicável a partir da versão 11.0.

O campo inventory se tornará obsoleto e será substituído pelo novo campo quantity_to_sell_on_facebook. Continuaremos oferecendo compatibilidade com o campo inventory no futuro próximo, mas recomendamos que você comece a usar o novo campo quantity_to_sell_on_facebook.

Os seguintes pontos de extremidade serão afetados:

Consulte Quantidade para venda e Campos compatíveis com produtos – anúncios dinâmicos e comércio para mais informações sobre essa atualização.

Exclusão de grupos de produtos não vazios

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

A exclusão de grupos de produtos não vazios deixará de ser permitida por padrão. É possível excluir grupos de produtos não vazios ao aplicar deletion_method=delete_items à solicitação de exclusão. Isso excluirá o grupo de produtos e os itens dele.

O seguinte ponto de extremidade será afetado:

DELETE /<product_group_id>

Exclusão de conjuntos de produtos publicados

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

A exclusão de um catálogo com conjuntos de produtos publicados deixará de ser permitida por padrão. Para permitir esse tipo de exclusão, defina o parâmetro allow_delete_catalog_with_live_product_set do catálogo em questão como true.

Essa alteração afetará o seguinte ponto de extremidade:

DELETE /<product_catalog_id>

Novo ponto de extremidade de diagnóstico

Aplicável a partir da versão 11.0.

Adicionamos o ponto de extremidade GET /{product_catalog_id}/diagnostics. Ele pode ser usado para recuperar dados de diagnóstico de determinado catálogo, por exemplo, problemas que impedem a exibição de produtos em canais, além de oportunidades de melhoria para a visibilidade de produtos.

API de Comércio

Detalhes do pagamento total estimado do pedido

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

Estamos mudando a forma como os detalhes do pagamento estimado são informados nos totais do pedido para chamadas ao ponto de extremidade {commerce-order-id}/?fields=estimated_payment_details. Antes, aplicava-se um imposto estimado em caso de pedidos não atendidos e um imposto real para pedidos atendidos. A partir da versão 11.0, o ponto de extremidade sempre usará o imposto estimado. É possível ver detalhes sobre o imposto real por meio de {commerce-order-id}/items?fields=tax_details.

Conversion Lift

Alterações em métricas

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

As métricas retornadas do campo GET /{objective-id}/?fields=result foram alteradas.

As métricas a seguir foram adicionadas:

conversions_incremental_share
conversions_CPiC
conversions_multicell_confidence
conversions_multicell_rank
sales_incremental_share
sales_multicell_confidence
sales_multicell_rank
buyers_incremental_share
buyers_CPiB
buyers_multicell_confidence
buyers_multicell_rank

As seguintes métricas foram removidas:

advancedBuyers.control
ancedBuyers.informativeMultiCellBayesianConfidence
advancedBuyers.lift
advancedBuyers.test
advancedConversions.control
advancedConversions.informativeMultiCellBayesianConfidence
advancedConversions.lift
advancedConversions.test
advancedSales.control
advancedSales.informativeMultiCellBayesianConfidence
advancedSales.lift
advancedSales.test
buyers.baseline
buyers.bayesianCILower
buyers.bayesianCIUpper
buyers.control
buyers.delta
buyers.incremental
buyers.isStatSig
buyers.lift
buyers.multiCellBayesianConfidence
buyers.reachedPercent
buyers.singleCellBayesianConfidence
conversions.baseline
conversions.bayesianCILower
conversions.bayesianCIUpper
conversions.control
conversions.delta
conversions.incremental
conversions.isStatSig
conversions.lift
conversions.multiCellBayesianConfidence
conversions.reachedPercent
conversions.singleCellBayesianConfidence
frequency
incrementalROAS
sales.baseline
sales.bayesianCILower
sales.bayesianCIUpper
sales.control
sales.delta
sales.incremental
sales.isStatSig
sales.lift
sales.multiCellBayesianConfidence
sales.singleCellBayesianConfidence

As seguintes métricas foram renomeadas:

Nome antigo	Nome novo
`advancedBuyers.baseline`	`buyers_not_exposed`
`advancedBuyers.bayesianCILower`	`buyers_incremental_lower`
`advancedBuyers.bayesianCIUpper`	`buyers_incremental_upper`
`advancedBuyers.incremental`	`buyers_incremental`
`advancedBuyers.informativeMultiCellPairwiseBayesianConfidence`	`buyers_multicell_confidence`
`advancedBuyers.informativeSingleCellBayesianConfidence`	`buyers_confidence`
`advancedBuyers.scaled`	`buyers_control_scaled`
`advancedConversions.baseline`	`conversions_not_exposed`
`advancedConversions.bayesianCILower`	`conversions_incremental_lower`
`advancedConversions.bayesianCIUpper`	`conversions_incremental_upper`
`advancedConversions.incremental`	`conversions_incremental`
`advancedConversions.informativeMultiCellPairwiseBayesianConfidence`	`conversions_multicell_confidence`
`advancedConversions.informativeSingleCellBayesianConfidence`	`conversions_confidence`
`advancedConversions.scaled`	`conversions_control_scaled`
`advancedSales.baseline`	`sales_not_exposed`
`advancedSales.bayesianCILower`	`sales_incremental_lower`
`advancedSales.bayesianCIUpper`	`sales_incremental_upper`
`advancedSales.incremental`	`sales_incremental`
`advancedSales.informativeMultiCellPairwiseBayesianConfidence`	`sales_multicell_confidence`
`advancedSales.informativeSingleCellBayesianConfidence`	`sales_confidence`
`advancedSales.scaled`	`sales_control_scaled`
`buyers.pValue`	`buyers_raw_pValue`
`buyers.reached`	`buyers_exposed`
`buyers.scaled`	`buyers_control_raw_scaled`
`buyers.test`	`buyers_test`
`conversions.pValue`	`conversions_raw_pValue`
`conversions.reached`	`conversions_exposed`
`conversions.scaled`	`conversions_control_raw_scaled`
`conversions.test`	`conversions_test`
`IncrementalROAS`	`sales_ROAS`
`sales.pValue`	`sales_raw_pValue`
`sales.reached`	`sales_exposed`
`sales.scaled`	`sales_control_raw_scaled`
`sales.test`	`sales_test`

Você pode acessar uma lista completa das métricas disponíveis no Glossário de métricas do Lift do Facebook.

API de Insights

Descontinuação das métricas de visita ao estabelecimento

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 6 de setembro de 2021.

As métricas store_visits_actions e cost_per_store_visit_actions se tornaram obsoletas.

Os seguintes pontos de extremidade serão afetados:

API de Anúncios de Oferta

Descontinuação dos pontos de extremidade da API de Anúncios de Oferta

Aplicável a partir da versão 11.0. As alterações serão aplicadas a todas as versões em 7 de setembro de 2021.

Como parte do nosso esforço contínuo para aumentar a estabilidade do produto, o Facebook encerrará o suporte ao produto Anúncios de oferta em 8 de junho de 2021. Recomendamos usar os anúncios do Facebook como substitutos para distribuir descontos online ou na loja. Coloque as informações do desconto, os locais de resgate, a data de validade e os códigos promocionais diretamente no criativo do nível do anúncio.

Os seguintes pontos de extremidade estão obsoletos:

GET /{page-id}/nativeoffers
POST /[page-id}/nativeoffers
GET /pagename/nativeoffers
GET /{native-offer-id}
GET /{native-offer-id}/views
POST /{native-offer-id}/codes
POST /{native-offer-id}/nativeofferviews
GET /{offer-id}/comments
GET /{offer-id}/sharedposts
GET /{offer-id}/likes