Versão 8.0

Graph API

Lançada em 4 de agosto de 2020 | Disponível até 1º de novembro de 2022 | Publicação de blog

Tokens de acesso

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /token_deprecation_check

Álbuns

Pontos de extremidade restabelecidos

Aplicável a todas as versões.

• GET /{album-id}/likes

Configurações do app

Tipos de app

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

Para apps criados recentemente, é possível escolher o tipo: Negócios, Jogos ou Nenhum. A remoção de permissões e recursos inadequados com base no tipo escolhido simplifica a análise do app. Além disso, os apps de negócios não usam mais modos, mas sim um novo mecanismo de autorização. Além disso, eles têm acesso a um novo recurso. Para ver mais detalhes, consulte a entrada do registro de alterações dos apps de negócios.

Apps de negócios

Os apps de negócios usam um novo mecanismo de autorização chamado níveis de acesso. Os níveis de acesso substituem a funcionalidade fornecida pelo modo de desenvolvimento e o modo publicado (que foram removidos dos apps de negócios) e tornam o processo de análise mais simples e intuitivo. Além disso, um novo recurso de acesso ao perfil do usuário de ativo da empresa foi lançado, o que permite que os apps de negócios leiam um conjunto reduzido de campos públicos de usuários. Essas alterações estão descritas em mais detalhes abaixo.

Níveis de acesso

Aplicável a todas as versões.

Os níveis de acesso são um novo mecanismo de autorização da Graph API para apps de negócios que se aplicam individualmente a permissões e recursos. O Acesso padrão autoriza o acesso somente a dados de propriedade de usuários que têm uma função no app ou em uma empresa que o adquiriu. O Acesso avançado permite acessar dados de propriedade de qualquer usuário, mas exige a análise do app. Os apps de negócios são automaticamente aprovados para o Acesso padrão em todos os recursos e permissões disponíveis para esse tipo de app.

Remoção do modo de desenvolvimento e do modo publicado

Aplicável a todas as versões.

O modo de desenvolvimento e o modo publicado foram removidos dos apps de negócios. Esses modos foram substituídos por níveis de acesso, que fornecem a mesma funcionalidade e versatilidade. Como os apps de negócios têm Acesso padrão para todas as permissões e recursos disponíveis, qualquer usuário com função no app ou em uma empresa que o adquiriu pode conceder acesso às permissões disponíveis a qualquer momento. Isso elimina a necessidade de executar a análise do app ou de alternar modos durante o desenvolvimento.

Novo recurso de acesso ao perfil do usuário de ativo da empresa

Aplicável a todas as versões.

O novo recurso de acesso ao perfil do usuário de ativo da empresa permite que apps de negócios leiam um conjunto reduzido de campos públicos de um usuário, desde que o usuário tenha interagido com ativos de propriedade de uma empresa que obteve o app. Consulte a referência de acesso ao perfil do usuário de ativo da empresa para ver uma lista de campos públicos que podem ser lidos.

Comentários

Pontos de extremidade restabelecidos

Aplicável a todas as versões.

• GET /{comment-id}/likes

Dispositivos

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• POST /device/share

Grupos

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{group-id}/posts

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /{group-post-id}/likes

Instagram

Novo ponto de extremidade oEmbed do Instagram

Aplicável a todas as versões.

Um novo ponto de extremidade GET /instagram_oembed foi introduzido. Ele fornece a mesma funcionalidade que os pontos de extremidade oEmbed herdados do Instagram, que serão descontinuados em 24 de outubro de 2020. O novo ponto de extremidade exige um token de acesso. Por isso, você precisará ter uma conta de desenvolvedor do Facebook e um app registrado para acessá-lo. Consulte o documento sobre oEmbed do Instagram para ver instruções de uso e detalhes adicionais.

Acontecimentos

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{life-event-id}
• GET /{life-events-id}/photos

Links

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{link-id}/reactions

Vídeos ao vivo

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{live-video-id}/likes

Use o ponto de extremidade GET /{live-video-id}/reactions para obter curtidas em um LiveVideo.

Parâmetro save_vod

Aplicável à versão 8.0 e posteriores. As alterações serão aplicadas a todas as versões em 2 de novembro de 2020.

O parâmetro save_vod foi descontinuado para as seguintes bordas:

• POST /{user_id}/live_videos
• POST /{group_id}/live_videos
• POST /{page_id}/live_videos
• POST /{event_id}/live_videos

Plataforma do Messenger

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{page-id}/thread_settings
• POST /{page-id}/thread_settings
• DELETE /{page-id}/thread_settings

Análise do app

Aplicável a todas as versões.

A análise do app para o Messenger foi movida de Produtos > Messenger > Configurações para Análise do aplicativo no Painel de Aplicativos. Para solicitar as permissões específicas do Messenger, pages_messaging, pages_user_gender, pages_user_locale e pages_user_timezone, acesse Análise do aplicativo > Permissões e recursos. Consulte a documentação sobre análise do app para o Messenger se quiser mais detalhes.

Borda do perfil do Messenger

Aplicável à versão 8.0 e posteriores.

O tipo de menu persistente aninhado foi descontinuado e alterado para POST /{page-id}/messenger_profile.

Novo recurso: Messenger para Lojas

Aplicável à versão 8.0 e posteriores.

Suporte ao envio e recebimento de produtos no Messenger para Lojas. Isso inclui o modelo de produto que pode ser usado para enviar produtos em mensagens, Webhooks para mensagens com modelo de produto e na página de detalhes do produto de Lojas do Facebook, além dos echo webhooks para mensagens com produtos.

• GET /{message_id}/access_requests
• POST {page_id}/message
• message_echo Webhook
• messages Webhook

Ofertas nativas

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{native-offer-id}/nativeofferviews?photos

Open Graph

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /{open-graph-action-id}/comments
• POST /{open-graph-action-id}/comments

Páginas

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• DELETE /{page-id}/tabs
• GET /{group-id}/posts
• GET /{page-id}/place_topics
• GET /{page-about-story-id}
• POST /{page-about-story-id}
• POST /{page-id}/page_about_story

Publicação da Página

Descontinuados em todas as versões.

O formato de ID de comentário de Publicações da Página, {page-id}_{post_id}_{comment-id}, foi descontinuado. Use o formato {pagepost-id}_{comment-id}.

Fotos

Pontos de extremidade descontinuados

Descontinuados em todas as versões.

• GET /{photo-id}/sharedposts

Locais

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{place-information-id} (consulte Correções)

Publicações

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /{post-id}/likes

Use o ponto de extremidade GET /post/reactions para receber curtidas em uma publicação.

Pesquisa

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /search?type=place
• GET /search?type=audience_interest

Configurações de segurança

Campos obsoletos

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em novembro de 2020.

• secure_browsing

Plugins Sociais

Pontos de extremidade oEmbed do Facebook

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

Os pontos de extremidade oEmbed do Facebook, que permitem que apps tenham HTML incorporado para vídeos e publicações públicas do Facebook, serão descontinuados em 24 de outubro de 2020. Foram lançados três novos pontos de extremidade que fornecem a mesma funcionalidade dos antigos que eles estão substituindo:

• GET /oembed_page
• GET /oembed_post
• GET /oembed_video

Os novos pontos de extremidade exigem um token de acesso e as solicitações estarão sujeitas à limitação de volume. Consulte a documentação sobre o novo ponto de extremidade oEmbed para ver detalhes sobre o uso e informações adicionais.

Usuários

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{user-id}/taggable_friends

Campos obsoletos

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em novembro de 2020.

• security_settings
• test_group
• viewer_can_send_gift
• is_shared_login

Descontinuados em todas as versões.

• can_review_measurement_request
• is_famedeeplinkinguser

Nova autorização

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

A partir de 24 de outubro de 2020, os campos a seguir exigirão uma nova autorização para acesso a dados após 90 dias de inatividade:

• is_eligible_promo
• payment_mobile_pricepoint
• payment_pricepoints

Foto do usuário

Aplicável a todas as versões em 24 de outubro de 2020.

A partir de 24 de outubro de 2020, o ponto de extremidade GET /{user-id}/picture (GET /{user-id}?fields=picture) exigirá um ID do usuário no escopo do app (ASID) para solicitações sem token. Se você consultar o usuário com um ID que não seja ASID, será necessário incluir um token de acesso de app, cliente ou usuário na solicitação. Consulte a referência sobre foto do usuário para ver mais detalhes.

Perguntas em vídeo

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /{question-id}
• GET /{question-id}/options
• GET /{question-id}/votes
• GET /{question-option-id}

Workplace

Pontos de extremidade descontinuados

Descontinuado na versão 8.0 e posteriores. Serão descontinuados em todas as versões em 2 de novembro de 2020.

• GET /{company-id}/access_requests
• GET /access_requests

API de Marketing

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

Contas de anúncios

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET /AdReportSchedule
• DELETE act_{ad-account-id}/adsets

Permissões

Aplicável à versão 8.0 e posteriores. As alterações serão aplicadas a todas as versões em 2 de novembro de 2020.

Os apps precisam de permissões granulares para acessar os campos da empresa de uma conta de anúncios. As permissões devem ser concedidas para um objeto específico da empresa.

Regras de personalização de ativo

Validação

Aplicável à versão 8.0 e posteriores.

Todos os anúncios que usam asset_feed_spec precisam conter ao menos duas regras de personalização de direcionamento. Caso seu criativo use asset_feed_spece tenha menos de duas regras, não será possível criar o anúncio.

Essa alteração afeta a personalização de ativo de posicionamento, os anúncios em vários idiomas e a personalização de ativo de segmento.

Personalização de ativo de segmento

Aplicável à versão 8.0 e posteriores. As alterações serão aplicadas a todas as versões em 2 de novembro de 2020.

Todos os casos de uso não relacionados à localização geográfica foram descontinuados para usuários da Personalização de ativo de segmento. Agora, todas as regras de direcionamento devem conter informações sobre localização geográfica nas especificações de personalização. Há uma exceção para a regra padrão, que não precisa incluir localização geográfica.

Lances

Estratégia de lance de custo-alvo

Aplicável à versão 8.0 e posteriores

A estratégia de lance TARGET_COST foi descontinuada. Para continuar controlando os custos, recomendamos usar os lances de limite de custo. Veja todas as estratégias de lances disponíveis.

Gerenciador de Negócios

Pontos de extremidade descontinuados

Descontinuados na versão 8.0 e posteriores.

• GET{system-user-id}/updated_by

Pontos de extremidade de acordos de compartilhamento restabelecidos

Aplicável a todas as versões

Os pontos de extremidade a seguir foram restabelecidos:

• /{business-id}/received_sharing_agreements
• /{business-id}/initiated_sharing_agreements

Ambos os pontos de extremidade tinham sido descontinuados com o lançamento da Graph API V6.0.

Canvas

Pontos de extremidade descontinuados

• /{canvas-id}/collection_hero_image
• /{canvas-id}/collection_hero_video
• /{canvas-id}/collection_thumbnails

API de Catálogo

Permissões

Aplicável à versão 8.0 e posteriores. As alterações serão aplicadas a todas as versões em 31 de janeiro de 2021.

Você não precisa mais da permissão ads_management para acessar pontos de extremidade do catálogo de produtos. De agora em diante, você precisará da permissão catalog_management para fazer uma chamada a esses pontos de extremidade. Até 14 de agosto de 2020, os desenvolvedores que têm acesso ao catálogo de pontos de extremidade via ads_management nos últimos 90 dias serão migrados automaticamente para permissões catalog_management.

A partir de agora e até 28 de fevereiro de 2021, os desenvolvedores que usam versões anteriores da API ainda poderão fazer chamadas a pontos de extremidade do catálogo de produtos com a permissão ads_management. Se você estiver usando a versão 8.0, será preciso ter a permissão catalog_management.

Após o prazo em fevereiro, a permissão catalog_management não estará mais associada a ads_management. Por isso, os usuários precisarão conceder a permissão catalog_management especificadamente para o seu app.

Autenticação

Aplicável à versão 8.0 e posteriores. As alterações serão aplicadas a todas as versões em 2 de novembro de 2020.

[ATUALIZADO] Os seguintes pontos de extremidade da API do Catálogo agora seguem as configurações da empresa para a autenticação de dois fatores. Os apps que fizerem uma chamada para esse ponto de extremidade receberão uma mensagem de erro se a empresa que possui o catálogo exigir autenticação de dois fatores para o atual usuário do app e ele não tiver realizado essa autenticação.

Quando o atual usuário do app tem acesso ao catálogo por meio de uma empresa parceira, atendemos aos requisitos de autenticação do Gerenciador de Negócios do parceiro. Os usuários do sistema não precisam de uma autenticação de dois fatores.

• POST /{business-id}/owned_product_catalogs
• POST /{destination-id}
• POST /{home-listing-id}
• DELETE /{home-listing-id}
• POST /{hotel-id}
• DELETE /{hotel-id}
• POST /{hotel-id}/hotel_rooms
• POST /{hotel-room-id}
• DELETE /{hotel-room-id}
• POST /{page-id}/product_catalogs
• POST /{product-catalog-id}
• DELETE /{product-catalog-id}
• POST /{product-catalog-id}/agencies
• DELETE /{product-catalog-id}/agencies
• POST /{product-catalog-id}/assigned_users
• DELETE /{product-catalog-id}/assigned_users
• POST /{product-catalog-id}/batch
• POST /{product-catalog-id}/categories
• POST /{product-catalog-id}/destinations
• POST /{product-catalog-id}/external_event_sources
• DELETE /{product-catalog-id}/external_event_sources
• POST /{product-catalog-id}/flights
• POST /{product-catalog-id}/home_listings
• POST /{product-catalog-id}/hotel_rooms_batch
• POST /{product-catalog-id}/hotels
• POST /{product-catalog-id}/items_batch
• /{product-catalog-id}/pricing_variables_batch
• POST /{product-catalog-id}/product_groups
• POST /{product-catalog-id}/product_feeds
• POST /{product-catalog-id}/product_sets
• POST /{product-catalog-id}/products
• POST /{product-catalog-id}/vehicles
• POST /{product-feed-rule-id}
• DELETE /{product-feed-rule-id}
• POST /{product-feed-id}
• DELETE /{product-feed-id}
• POST /{product-feed-id}/rules
• POST /{product-feed-id}/uploads
• POST /{product-feed-id}/upload_schedules
• POST /{product-feed-schedule-id}
• DELETE /{product-feed-schedule-id}
• POST /{product-feed-upload-id}/error_report
• POST /{product-group-id}
• DELETE /{product-group-id}
• POST /{product-group-id}/products
• POST /{product-item-id}
• DELETE /{product-item-id}
• POST /{product-set-id}
• DELETE /{product-set-id}
• POST /{vehicle-id}

Relatórios

Itens que se tornaram obsoletos

Aplicável à versão 8.0 e posteriores

• GET /{ad-study-id}?fields=split_test_config
• GET /{ad-study-id}?fields=iterative_split_test_config

Direcionamento

Item que se tornou obsoleto

Aplicável à versão 8.0 e posteriores

• GET /search?type=adzipcode

Correções

• 28 de setembro de 2020 — A entrada de autenticação da API de Catálogo foi atualizada para estar mais clara.
• 23 de outubro de 2020 — A entrada da API de Catálogo foi atualizada:

  • Estendemos o prazo para que os desenvolvedores que usam versões anteriores da API ainda possam fazer chamadas a pontos de extremidade do catálogo de produtos com a permissão ads_management. O novo prazo final é 28 de fevereiro de 2021.
  • Adicionamos esclarecimentos sobre a autenticação de usuário do sistema.
• 17 de maio de 2021 — O ponto de extremidade descontinuado foi alterado de GET /{place-id} para GET /{place-information-id}. GET /{place-id} não foi descontinuado.