Version 11.0

API Graph

Publiée le 8 juin 2021 | Disponible jusqu’au 14 septembre 2023 | Publication de blog

Applications grand public

Niveaux d’accès

S’applique à toutes les versions.

Dans les semaines à venir, les niveaux d’accès s’appliqueront à toutes les applications grand public existantes. Pour ces applications, les autorisations et les fonctionnalités déjà approuvées via le processus Contrôle app seront approuvées automatiquement pour l’accès avancé. Toutes les autres autorisations et fonctionnalités seront approuvées automatiquement pour l’accès standard.

Les niveaux d’accès s’appliqueront également à toutes les applications nouvellement créées dans les semaines à venir. Les applications nouvellement créées seront approuvées automatiquement pour l’accès avancé en ce qui concerne les autorisations e-mail et public_profile. Toutefois, ces deux autorisations seront définies sur l’accès standard par défaut et elles devront être définies manuellement sur l’accès avancé avant de pouvoir être demandées par les utilisateurs d'applications qui n'ont pas de rôle dans ces applications.

Assistance pour les développeurs

Nous avons mis à disposition l’outil Facebook for Business Status pour surveiller l’état de la plateforme et les produits commerciaux tels que le Gestionnaire de publicités, Whatsapp Business et la plateforme Facebook for Developers.

Facebook Analytics

Abandon

S’applique à toutes les versions.

Facebook Analytics ne sera plus disponible après le 30 juin 2021. De plus, nous ne prenons plus en charge le plugin de l’Espace App pour l’API Marketing. Pour en savoir plus, consultez les pages d’aide Business.

Les champs suivants du nœud application ne sont plus disponibles :

analytics_config
analytics_platform_metrics_config
permissible_ad_accounts

Les points de terminaison suivants ne sont plus disponibles :

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 Basic Display pour Instagram

Débogueur de token d’accès

S’applique à toutes les versions.

L’outil débogueur de token d’accès ne renvoie désormais qu’un ID spécifique à une app lors du débogage d’un token.

Gestion des versions de l’API

S’applique à toutes les versions.

L’API prend désormais en charge les appels avec version. Pour cibler une version spécifique de l’API, saisissez le numéro de version dans le chemin de la requête après l’URL de base. Par exemple :

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

Les demandes sans version (auxquelles il manque le numéro de version) se résolvent dans la version spécifiée dans le paramètre Espace App > Paramètres > Avancé > Mettre à niveau la version de l’API de l’application d’appel.

ID utilisateurs spécifiques d’une application

Concerne les versions 11.0 et supérieures.

Des ID utilisateurs spécifiques à une app (ASID) ont été mis en place. Les ASID remplaceront les ID utilisateurs bruts dans approximativement deux ans, lorsque la version 10.0 ne sera plus prise en charge. Nous vous recommandons de ce fait de commencer à mapper les ID bruts des utilisateurs de vos applications et leurs ASID correspondants.

Toutes les versions prennent en charge les requêtes basées sur les ID utilisateurs bruts.
Seuls les appels des versions 11.0 et supérieures prennent en charge les requêtes basées sur les ASID.
Les appels des versions 11.0 et supérieures recevront des ASID en réponse, même lors d’une demande d’ID utilisateurs bruts.

Pagination en fonction du temps

Concerne les versions 11.0 et supérieures.

Paramètres since et until ajoutés au point de terminaison GET /{user-id}/media pour prendre en charge la pagination en fonction du temps.

API Graph pour Instagram

Nombre de mentions J’aime

Concerne la version 11.0 et les versions ultérieures. S’appliquera à toutes les versions à compter du 7 septembre 2021.

Si vous interrogez un objet Contenu multimédia Instagram de manière indirecte par le biais d’un autre point de terminaison ou élargissement de champ, le champ like_count sera omis des réponses de l’API si le propriétaire du contenu multimédia a des mentions J’aime masquées. Si vous interrogez l’objet Contenu multimédia Instagram de manière directe (c’est-à-dire par l’intermédiaire de son propriétaire), le nombre réel de mentions J’aime sera renvoyé, même si les nombres de mentions J’aime ont été masqués.

Pagination en fonction du temps

Concerne les versions 11.0 et supérieures.

Paramètres since et until ajoutés au point de terminaison GET /{ig-user-id}/media pour prendre en charge la pagination en fonction du temps.

Instant Experiences

Modèles

Concerne les versions 11.0 et supérieures.

Les modèles Instant Experience ne se trouvent plus dans la version bêta et sont désormais accessibles à tous les développeurs.

Plateforme Messenger

Webhook de postback de message

Concerne les versions 11.0 et supérieures.

Le champ mid a été ajouté au webhook messaging_postbacks pour que les applications puissent obtenir l’ID de message.

Abandon des modèles pour les compagnies aériennes

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 6 décembre 2021.

Les appels aux POST /{page-id}/messages qui incluent des modèles pour compagnies aériennes (template_type des types airline_boardingpass, airline_checkin, airline_itinerary, airline_update) n’aboutiront pas.

oEmbed

Nouvelle fonctionnalité oEmbed Read

S’applique à toutes les versions.

Le produit oEmbed a été remplacé par une nouvelle fonctionnalité oEmbed Read. Si vous avez implémenté le produit oEmbed avant le 8 juin 2021, vous avez jusqu’au 7 septembre 2021 pour effectuer le Contrôle app sur la fonctionnalité oEmbed Read. Si vous n’obtenez pas l’approbation pour la fonctionnalité oEmbed Read d’ici le 7 septembre 2021, le chargement de vos implémentations oEmbed échouera.

API Pages

ID de commentaires

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Le champ iddes commentaires ne sera pas renvoyé pour les applications qui utilisent uniquement la fonctionnalité d’accès au contenu public de la Page pour interroger les points de terminaison. Cela comprend les champs id/PAGEPOST-ID/comments et /COMMENT-ID/comments. Pour obtenir les champs id de commentaires pour les commentaires de publications de Page, l’utilisateur ou l’utilisatrice de l’application doit pouvoir effectuer la tâche MODERATE sur la Page concernée.

Nouvelle expérience de Page

Dans les mois à venir, toutes les pages classiques passeront à la Nouvelle version des Pages. Utilisez le has_transitioned_to_new_page_experience champ de la Page pour savoir s’il y a eu une migration de Page. Une fois la migration de toutes les Pages effectuée, la version classique des Pages ne sera plus disponible.

La plupart des points de terminaison de l’API Pages prennent en charge la version classique et la nouvelle version des Pages. Les points de terminaison qui prennent en charge la nouvelle version des Pages ont une section « Nouvelle version des Pages » dans leurs références.

Les points de terminaison suivants ne prennent pas en charge la nouvelle version des Pages :

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

Certains champs de Page ne sont pas disponibles dans la nouvelle version, et ils renverront la mention null, un autre ensemble de données ou une erreur lorsqu’ils seront appelés. Consultez notre Présentation de la nouvelle version des Pages pour obtenir la liste de ces champs de Page.

Autorisations

user_likes

S’applique à toutes les versions.

L’usage permis pour l’autorisation user_likes a été mis à jour. À compter du 7 septembre 2021, les applications qui ont déjà été approuvées pour cette autorisation, mais qui ne respectent pas la nouvelle description d’usage, verront leur approbation révoquée.

Ancien usage autorisé : pour améliorer considérablement la qualité de l’expérience d’utilisation de votre application (l’utilisateur ou utilisatrice doit savoir quel traitement est effectué sur ses données pour fournir cette expérience).
Nouvel usage autorisé : pour offrir une expérience personnalisée en mettant en corrélation ou en affichant le contenu relatif aux mentions J’aime d’une personne. Cela inclut d’entretenir le contenu à grande échelle pour personnaliser les applications ayant de grandes quantités de contenu et permettre aux personnes de partager ce qu’elles aiment avec d’autres, par exemple dans les applications de rencontres et de musique.

user_posts

S’applique à toutes les versions.

L’usage permis pour l’autorisation user_posts a été mis à jour. À compter du 7 septembre 2021, les applications qui ont déjà été approuvées pour cette autorisation, mais qui ne respectent pas la nouvelle description d’usage, verront leur approbation révoquée.

Ancien usage autorisé : pour améliorer considérablement la qualité de l’expérience utilisateur de votre application (l’utilisateur doit savoir quel traitement est effectué sur ses données pour fournir cette expérience).
Nouvel usage autorisé : permettre aux personnes de créer des livres ou des albums physiques ou numériques de leurs journaux, et de partager des souvenirs de leur journal sur Facebook ou sur d'autres applications sociales.

SDK

Consultez le changelog du SDK pour iOS, le changelog du SDK pour Android et le changelog du SDK pour Unity pour en savoir plus sur les changements importants à venir concernant ces SDK.

API Marketing

Publiée le 8 juin 2021 | Disponible jusqu’au 23 février 2022 | Publication de blog

Audiences

Suppression des audiences personnalisées, des audiences similaires et des audiences enregistrées

S’applique à toutes les versions.

À compter du 8 juin 2021, les audiences personnalisées, similaires ou enregistrées, qui n'ont pas été utilisées dans un ensemble de publicités actives depuis plus de deux ans, seront marquées comme « Audiences arrivées à expiration ». L’audience concernée est alors programmée pour être supprimée 90 jours après avoir été marquée comme « Audience arrivée à expiration ».

Les développeurs pourront filtrer le statut « Audience arrivée à expiration » à l’aide du champ operation_status et voir une estimation du délai de suppression de l’audience dans le système à l’aide du champ delete_time. Les développeurs peuvent choisir de supprimer proactivement l’audience ou de l’utiliser dans un ensemble de publicités pour éviter sa suppression. Lorsqu’une audience a été supprimée, les annonceurs ne peuvent pas la réactiver.

Pour les audiences personnalisées (sauf les audiences personnalisées du fichier clientèle), les audiences similaires ou les audiences enregistrées :

Si les annonceurs souhaitent que les audiences marquées soient supprimées automatiquement à compter du 6 septembre 2021, ils n’ont aucune démarche à faire. Toutefois, si les annonceurs le souhaitent, ils peuvent également supprimer proactivement l’audience avant la date de suppression automatique.
Si les annonceurs souhaitent conserver des audiences marquées, ils doivent les utiliser dans un ensemble de publicités actives avant le 6 septembre 2021 pour éviter leur suppression.

Pour les audiences personnalisées basées sur un fichier clientèle :

Nous les stockons pour les annonceurs conformément à leurs instructions. Si les annonceurs n’utilisent pas les audiences marquées dans un ensemble de publicités actives avant le 6 septembre 2021, nous considérerons cela comme une instruction de supprimer ces audiences marquées.

Les points de terminaison et les champs suivants seront concernés :

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

Consultez la section Présentation des audiences : changements en matière de suppression des audiences personnalisées pour en savoir plus sur ces mises à jour.

API Business

S’applique à toutes les versions.

Nous limitions temporairement l’accès aux points de terminaison suivants. Seules les applications ayant appelé effectivement ces points de terminaison au cours des 30 derniers jours conserveront leur accès.

Toutes les autres applications recevront une erreur lorsqu’elles effectueront un appel sur ces points de terminaison.

API Catalog

Abandon du champ Inventaire de produits

Concerne les versions 11.0 et supérieures.

Le champ inventory ne sera plus utilisé et sera remplacé par un nouveau champ quantity_to_sell_on_facebook. Même si nous continuons à prendre en charge le champ inventory à court terme, nous vous recommandons d’utiliser le nouveau champ quantity_to_sell_on_facebook à la place.

Les points de terminaison suivants sont concernés :

Consultez la section Quantité à vendre et Champs pris en charge pour les produits - Publicités dynamiques & Commerce pour en savoir plus sur cette mise à jour.

Suppression des groupes de produits non vides

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Nous n’autoriserons plus la suppression des groupes de produits non vides par défaut. Les groupes de produits non vides peuvent être supprimés en appliquant deletion_method=delete_items à la demande de suppression. Cela supprimera le groupe de produits ainsi que ses articles.

Le point de terminaison suivant est concerné :

DELETE /<product_group_id>

Suppression d’ensembles de produits en direct

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Nous n’autoriserons plus la suppression d’un catalogue contenant des ensembles de produits en direct par défaut. Pour permettre la suppression d’un catalogue contenant un ensemble de produits en direct, définissez le paramètre allow_delete_catalog_with_live_product_set du catalogue sur true.

Ce changement concerne le point de terminaison suivant :

DELETE /<product_catalog_id>

Nouveau point de terminaison de diagnostic

Concerne les versions 11.0 et supérieures.

Nous avons ajouté un nouveau point de terminaison GET /{product_catalog_id}/diagnostics. Ce point de terminaison peut être utilisé pour récupérer les données de diagnostic d’un catalogue donné, par exemple, les problèmes qui empêchent les produits de s’afficher dans les canaux et les opportunités qui pourraient améliorer la visibilité des produits.

API Commerce

Estimation des détails de paiement du total des commandes

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Nous changeons la manière dont l’estimation des détails de paiement est consignée dans le total des commandes pour les appels au point de terminaison {commerce-order-id}/?fields=estimated_payment_details. Auparavant, si une commande n'était pas exécutée, une taxe estimée était utilisée, et pour les commandes exécutées, la taxe exécutée était utilisée. À compter de la version 11.0, ce point de terminaison utilisera toujours la taxe estimée. Notez que les détails sur la taxe exécutée sont accessibles via {commerce-order-id}/items?fields=tax_details.

Conversion Lift

Changements en matière d’indicateurs

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Les indicateurs renvoyés par le champ GET /{objective-id}/?fields=result ont changé.

Les indicateurs suivants ont été ajoutés :

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

Les indicateurs suivants ont été supprimés :

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

Les indicateurs suivants ont été renommés :

Ancien nom	Nouveau nom
`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`

La liste complète des indicateurs disponibles peut être consultée dans le Glossaire des indicateurs de croissance Facebook.

API Insights

Abandon des indicateurs liés aux visites en point de vente

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 6 septembre 2021.

Les indicateurs store_visits_actions et cost_per_store_visit_actions ne sont plus utilisés.

Les points de terminaison suivants sont concernés :

API Offer Ads

Abandon des points de terminaison de l’API Offer Ads

Concerne les versions 11.0 et supérieures. Toutes les versions seront concernées à partir du 7 septembre 2021.

Dans le cadre de nos efforts continus visant à améliorer la stabilité de nos produits, nous ne prenons plus en charge notre produit Publicités pour une offre à compter du 8 juin 2021. Nous vous recommandons d’utiliser les publicités Facebook standard à la place pour diffuser vos remises en ligne ou en boutique. Placez les informations concernant les remises, les lieux concernés, les dates d’expiration et les codes promotionnels directement au niveau de la publicité dans le contenu publicitaire.

Les points de terminaison suivants ne sont plus utilisés :

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