Versión 2.10

API Graph | API de marketing

Las entradas del registro de cambios se clasifican de esta forma:

  • Nuevas funciones: productos o servicios nuevos, incluidos nodos, perímetros y campos.
  • Cambios: modificaciones efectuadas en productos o servicios existentes (sin incluir los elementos obsoletos).
  • Retiradas: productos o servicios existentes que se van a eliminar.
  • Cambios importantes en 90 días: cambios y retiradas que se llevarán a cabo 90 días después de que se publique la versión correspondiente.

Las nuevas funciones, los cambios y las retiradas solo atañen a esta versión. Los cambios importantes en 90 días afectan a todas las versiones.

Los cambios importantes no se incluyen aquí porque no están vinculados a publicaciones concretas.


API Graph

Lanzamiento: 18 de julio de 2017 | Disponible hasta: 7 de noviembre de 2019


Nuevas funciones

Webhooks

  • Webhooks para eventos de página: estas acciones ahora activarán una actualización para las suscripciones al campo feed de la página:

    • Publicar automáticamente un evento programado.
    • Comentar la historia de un evento.
    • Crear y publicar un evento.
    • Publicar un borrador de un evento.

Cambios

Asignaciones de crédito

  • GET /{extended-credit-id}: se ha cambiado el nombre de los siguientes campos:

    • Cambia invoice_email por extended_credit_emails.
    • Cambia invoice_group por extended_credit_invoice_groups.
    • Cambia sequential_liability_amount por allocated_amount.
  • GET /{extended-credit-id}: se han añadido los siguientes campos:

    • liable_biz_name fields
    • owner_business field con los subcampos id y name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id}: se han eliminado los siguientes campos:

    • business_id field
  • extended_credit_invoice_groups: se han añadido los siguientes subcampos:

    • ad_accounts con los subcampos account_id y name
    • email
    • id
    • name
  • CurrencyAmount: los siguientes campos devolverán ahora un objeto CurrencyAmount en lugar de devolver únicamente la cantidad:

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Páginas

Usuario

Webhooks

  • Medidas para el cumplimiento de las restricciones de la aplicación: se obtendrá un error si se especifica un identificador de acceso para un usuario que no cumpla las restricciones de la aplicación (como la de país o edad), a no ser que se especifique el parámetro appsecret_proof en la solicitud.

Retiradas

Eventos

  • GET /{event-id}/videos: se ha eliminado este perímetro.

Cambios importantes en 90 días

Comentarios

  • POST y DELETE /{comment-id}: este nodo ahora requiere un identificador de acceso a la página válido.

  • POST and DELETE /{object-id}/comments: este nodo ahora requiere un identificador de acceso a la página válido.

  • GET /{object-id}/comments: este perímetro ahora requiere un identificador de acceso válido.

URL

  • POST /{url}: este nodo ahora requiere un identificador de acceso válido.

  • GET /{url}: aunque ya no se devolverá el campo og_object, este se debe incluir en el parámetro de campos.

  • /{url} Extracción: las solicitudes GET ya no extraerán la URL. Ahora se debe usar POST /{url}.

Publicaciones

  • /{post-id}: este nodo ahora requiere un identificador de acceso válido.

Vídeos

  • /{video-id}: este nodo ahora requiere un identificador de acceso a la 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