Graph API

Versão 2.10

Graph API | API de Marketing

As entradas do Log de alterações são categorizadas da seguinte maneira:

  • Novos recursos — Novos produtos ou serviços, incluindo novos nós, bordas e campos.
  • Alterações — Alterações em produtos ou serviços existentes (não incluindo Itens que se tornaram obsoletos).
  • Itens que se tornaram obsoletos — Produtos ou serviços existentes que estão sendo removidos.
  • Alterações disruptivas em 90 dias — Alterações e itens obsoletos que entrarão em vigor 90 dias após a data de lançamento da versão.

Os Novos recursos, as Alterações e os Itens que se tornaram obsoletos afetam apenas esta versão. As Alterações disruptivas em 90 dias afetam todas as versões.

As Alterações disruptivas não estão incluídas aqui, uma vez que não estão vinculadas a lançamentos específicos.

Graph API

Lançado em 18 de julho de 2017 | Disponível até 7 de novembro de 2019

Novos recursos

Webhooks

  • Webhooks para eventos da Página – As seguintes ações agora dispararão uma atualização para as assinaturas do campo feed da Página:

    • Publicação automática de um evento programado
    • Comentários na história do evento
    • Criação e publicação de um evento
    • Publicação do rascunho de um evento

Mudanças

Alocações de crédito

  • GET /{extended-credit-id} – Os campos a seguir foram renomeados:

    • invoice_email para extended_credit_emails
    • invoice_group para extended_credit_invoice_groups
    • sequential_liability_amount para allocated_amount

  • GET /{extended-credit-id} – Os campos a seguir foram adicionados:

    • liable_biz_name fields
    • owner_business field com subcampos id e name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name

  • GET /{extended-credit-id} – O campo a seguir foi removido:

    • business_id field

  • extended_credit_invoice_groups – Os subcampos a seguir foram adicionados:

    • ad_accounts com os subcampos account_id e name
    • email
    • id
    • name

  • CurrencyAmount – Agora os campos a seguir retornarão um objeto CurrencyAmount, em vez de retornar apenas o valor:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Páginas

Usuário

Webhooks

  • Imposição de restrição do aplicativo – A especificação de um token de acesso para um usuário que não atende às restrições do aplicativo, como idade ou país, resultará em um erro, a menos que uma appsecret_proof seja especificada na solicitação.

Itens que se tornaram obsoletos

Eventos

  • GET /{event-id}/videos — Esta borda foi removida.

Alterações disruptivas em 90 dias

Comentários

  • POST e DELETE /{comment-id} – Agora este nó requer um token de acesso à Página válido.

  • POST and DELETE /{object-id}/comments – Agora este nó requer um token de acesso à Página válido.

  • GET /{object-id}/comments – Agora esta borda requer um token de acesso válido.

URLs

  • POST /{url} – Agora este nó requer um token de acesso válido.

  • GET /{url} – og_object não é mais retornado por padrão, mas deve ser incluído no parâmetro de campo.

  • /{url}Processamento – Solicitações GET não processarão mais a URL. A POST /{url} agora deve ser usada para isso.

Publicações

  • /{post-id} – Agora este nó requer um token de acesso válido.

Vídeos

  • /{video-id} – Agora este nó requer um token de acesso à Página válido.

Marketing API

Released July 18, 2017 | Available until May 8, 2018

New Features

  • No new features.

Changes

  • No changes.

Deprecations

  • No deprecations.

90-Day Breaking Changes

  • No 90-day breaking changes.

Breaking Changes in Marketing API v2.10

Ads Management

  • Holdout fields - The following fields have been deprecated from POST /{ad_account_id}/ads and GET /{ad_id}:

    • holdout_end
    • holdout_hash
    • holdout_start
    • no_show_offset
    • no_show_percentage
    • show_end
    • show_start

  • POST /{ad_account_id}/adcreatives - The following parameter is now deprecated:

    • follow_redirect

  • creative_rotation_parameter and creative_rotation type from GET ADSET_ID and POST AD_ACCOUNT_ID/adsets are deprecated.

  • Real-time bidding partner GET endpoints are deprecated. This includes GET /RTB_PARTNER_ID and GET /RTB_PARTNER_ID/stats endpoints. We also removed the field rtb_flag from POST /ADSET_ID and POST /ADGROUP_ID.

Signals and Targeting

  • Reach and Frequency Predictions - As of 2.10 we now provide target_spec as a JSON object; you no longer have to parse the response into JSON.

Insights

  • Breakdowns - The following types have been deprecated for the action_link_click_destination breakdown. See Insights, Breakdowns.

    • app_store_clicks
    • deeplink_clicks
    • website_clicks

Replaced by:

  • click_to_app_store
  • click_to_app_deeplink
  • click_to_website