Version 2.10

API Graph | API Marketing

Les éléments de changelog sont classés de la manière suivante :

  • Nouvelles fonctionnalités : les nouveaux produits ou services, notamment les nouveautés en matière de nœuds, d’arêtes et de champs.
  • Modifications : les modifications apportées aux produits ou services existants (hors Dépréciations).
  • Dépréciations : les produits ou services existants qui sont retirés.
  • Modifications importantes avec un préavis de 90 jours : les modifications et les dépréciations qui prendront effet 90 jours après la date de sortie de la version.

Les nouvelles fonctionnalités, les modifications et les dépréciations n’ont d’effets que sur la version concernée. Les modifications importantes avec un préavis de 90 jours concernent toutes les versions.

Les modifications importantes ne sont pas incluses ici, car elles ne sont pas liées à des versions particulières.


API Graph

Publiée le 18 juillet 2017 | Disponible jusqu’au 7 novembre 2019


Nouvelles fonctionnalités

Webhooks

  • Webhooks pour les évènements de Page : les actions suivantes déclencheront désormais une mise à jour pour les abonnements au champ feed de la Page.

    • Publier automatiquement un évènement programmé
    • Commenter l’actualité d’un évènement
    • Créer et publier un évènement
    • Publier une ébauche d’évènement

Modifications

Allocations de crédits

  • GET /{extended-credit-id} : les champs suivants ont été renommés :

    • invoice_email devient extended_credit_emails
    • invoice_group devient extended_credit_invoice_groups
    • sequential_liability_amount devient allocated_amount
  • GET /{extended-credit-id} : les champs suivants ont été ajoutés :

    • liable_biz_name fields
    • owner_business field avec les sous-champs id et name
    • owning_credit_allocation_configs
    • send_bill_to_biz_name
  • GET /{extended-credit-id} : le champ suivant a été supprimé :

    • business_id field
  • extended_credit_invoice_groups : les sous-champs suivants ont été ajoutés :

    • ad_accounts avec les sous-champs account_id et name
    • email
    • id
    • name
  • CurrencyAmount : les champs suivants renvoient désormais un objet CurrencyAmount plutôt qu’un simple montant :

    • allocated_amount
    • balance
    • max_balance
    • online_max_balance

Pages

Utilisateur

Webhooks

  • Mise en œuvre des restrictions de l’app : si vous spécifiez un token d’accès pour un utilisateur qui ne respecte pas les restrictions de l’application (par exemple, pays ou âge), vous obtenez une erreur, sauf si un paramètre appsecret_proof est indiqué dans la requête.

Dépréciations

Évènements

  • GET /{event-id}/videos : cette arête a été supprimée.

Modifications importantes avec un préavis de 90 jours

Commentaires

  • POST et DELETE /{comment-id} : ce nœud nécessite désormais un token d’accès de Page valide.

  • POST and DELETE /{object-id}/comments : ce nœud nécessite désormais un token d’accès de Page valide.

  • GET /{object-id}/comments : cette arête nécessite désormais un token d’accès valide.

URL

  • POST /{url} : ce nœud nécessite désormais un token d’accès valide.

  • GET /{url} : og_object n’est plus renvoyé par défaut, mais doit être inclus dans le paramètre des champs.

  • Récupération de /{url} : les demandes GET ne récupéreront plus l’URL. Une demande POST /{url} doit désormais être utilisée pour récupérer l’URL.

Publications

  • /{post-id} : ce nœud nécessite désormais un token d’accès valide.

Vidéos

  • /{video-id} : ce nœud nécessite désormais un token d’accès de Page valide.

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