Présentation de la version 26.0 des API Graph et Marketing

La version 26.0 des API Graph et Marketing comprend de nouvelles fonctionnalités, des abandons et des modifications importantes. Examinez les points à retenir ci-dessous et consultez le changelog de la version 26.0 pour obtenir la liste complète des modifications et des détails.

Dates et changements clés

• API Graph - Gestion des commandes commerciales : les appels aux points de terminaison concernés sur la version 26.0 et les versions ultérieures sont bloqués à partir du 29 juillet 2026. Les points de terminaison seront supprimés de toutes les versions restantes de l’API Graph le 27 octobre 2026. Après cette date, les appels renverront des erreurs. Aucune API ne remplace ces fonctionnalités.
• API Graph - Champs de propriétaire Rights Manager : à compter du 29 juillet 2026, avec la version 26.0, des champs de remplacement renvoyant le type RightsHolderOwner sont disponibles et les champs de propriétaire obsolètes ne sont plus renvoyés. Les champs obsolètes restent disponibles sur la version 25.0 et les versions antérieures pendant deux ans après le lancement de la version 26.0.
• API Graph - Fonctionnalités de protocole obsolètes : cinq comportements obsolètes seront supprimés des appels v26.0 à partir du 29 juillet 2026. Ce comportement s’applique à toutes les autres versions prises en charge de l’API Graph à compter du 27 octobre 2026.
• API Marketing - Publicités dans le statut WhatsApp : la version 26.0 ajoute des fonctionnalités d’identité, de ciblage, d’optimisation et de contenu publicitaire étendues à partir du 29 juillet 2026.
• API Marketing - Audience Advantage+ pour les campagnes portant sur le logement, l’emploi, et les produits et services financiers : à partir du 29 juillet 2026, avec la version 26.0, les ensembles de publicités nouveaux ou copiés avec un ciblage restreint doivent explicitement définir advantage_audience sur 1 ou 0. Pour les configurations par défaut ou moins restrictives, la valeur est toujours définie sur 1 par défaut, et les mises à jour des ensembles de publicités existants ne sont pas affectées.
• API Marketing - Fil Explorer Instagram : le placement n’est plus disponible dès la version 26.0 du 29 juillet 2026. Les développeurs doivent supprimer Explorer de leurs configurations de placement.
• API Marketing - Destination Web uniquement pour les campagnes Web+application : à partir du 29 juillet 2026, avec la version 26.0, les publicités ne pourront plus utiliser de contenu publicitaire avec applink_treatment défini sur web_only lorsque la campagne utilise les lieux de conversion Site Web et Application. La restriction s’applique à toutes les versions de l’API Marketing à compter du 27 octobre 2026.
• API Marketing - Stories Messenger : à compter des appels de la version 26.0 le 29 juillet 2026, la valeur story sera silencieusement supprimée de messenger_positions lors de la création ou de la mise à jour d’ensembles de publicités. L’abandon s’applique à toutes les versions de l’API Marketing, y compris les appels sans version, à compter du 27 octobre 2026.
• API Marketing : création de publicités avec sondage : à partir de la version 26.0 du 29 juillet 2026, les requêtes visant à créer un contenu publicitaire de sondage ou à modifier une publicité pour en utiliser un sont rejetées. Les mises à jour de publicités existantes qui ne modifient pas le contenu publicitaire restent prises en charge. L’abandon s’applique à toutes les versions de l’API Marketing à compter du 27 octobre 2026.
• API Graph et API Marketing : champs de diffusion estimée. Les champs de réponse daily_outcomes_curve, budget_guardrail, et estimate_dau seront supprimés des appels de la version 26.0 à compter du 29 juillet 2026, et de toutes les versions restantes à compter du 27 octobre 2026. Aucune API ne remplace ces fonctionnalités.
• Fin de prise en charge de la version de l’API Graph : l’API Graph v20.0 ne sera plus prise en charge à partir du 24 septembre 2026. La version 21.0 de l’API Graph sera obsolète et supprimée le 21 janvier 2027.

Mises à jour générales

API Marketing : assistance élargie pour les publicités dans Statut WhatsApp

À compter du 29 juillet 2026, l’API Marketing version 26.0 prendra en charge les publicités dans le statut WhatsApp, avec des fonctionnalités supplémentaires en matière d’identité, de ciblage, d’optimisation et de contenu publicitaire.

• Identité WhatsApp : les appelants tiers de l’API Marketing doivent inclure explicitement wamo_whatsapp_identity_spec dans les contenus publicitaires destinés à la diffusion sur Statut WhatsApp. L’identité WhatsApp n’est pas automatiquement définie par défaut pour ces appelants.
• Ciblage d’utilisateur·ices dont l’âge est inconnu : lorsque le placement Statut WhatsApp est sélectionné et que user_age_unknown n’est pas défini, le champ est défini par défaut sur true, ce qui signifie que la campagne peut toucher des utilisateur·ices de WhatsApp dont l’âge est inconnu.
• Optimisation : l’optimisation des conversions hors site est prise en charge pour les objectifs Ventes, Prospects et Interactions. L’optimisation Vues de la page de destination est également prise en charge.
• Format du contenu publicitaire : les publicités carrousel prennent en charge jusqu’à 10 fiches.

Consultez la documentation sur le ciblage de placement et le ciblage de base pour en savoir plus.

Abandons et modifications importantes

API Graph et API Marketing : suppression du champ de diffusion estimée

Les champs daily_outcomes_curve, budget_guardrail, et estimate_dau sont supprimés de la réponse du point de terminaison de l’estimation de diffusion, car le service qui alimente ces valeurs a été abandonné. À compter du 29 juillet 2026, ces champs ne seront plus renvoyés par l’API Graph v26.0 et l’API Marketing v26.0. Ce changement s’appliquera à toutes les versions restantes prises en charge des API Graph et Marketing à compter du 27 octobre 2026. Aucune API ne remplace ces fonctionnalités.

Les développeurs doivent cesser d’utiliser ces champs et supprimer toute référence à ceux-ci avant la date de suppression applicable.

Les points de terminaison représentatifs concernés sont les suivants :

• GET /{ad-account-id}/delivery_estimate - Ad account delivery estimates
• GET /{adset-id}/delivery_estimate - Estimations de diffusion des ensembles de publicités

La liste complète des champs et des points de terminaison sera disponible dans le changelog de la version 26.0.

API Graph : abandon de l’API de gestion des commandes commerciales

Les applications appelant ces points de terminaison sur la version 26.0 et les versions ultérieures de l’API Graph seront bloquées à partir du 29 juillet 2026. Les points de terminaison seront supprimés pour toutes les versions restantes de l’API Graph le 27 octobre 2026. Après cette date, les appels renverront des erreurs.

Le paiement directement sur Facebook et Instagram pour les boutiques a été entièrement désactivé. L’API de gestion des commandes commerciales autorisait les plateformes tierces à répertorier les commandes, consulter les détails de ces dernières, gérer les expéditions, traiter les annulations, gérer les remboursements et suivre les retours pour cette expérience de paiement. Comme l’infrastructure sous-jacente des commandes commerciales est en cours de retrait, ces points de terminaison ne sont plus pris en charge.

Les développeur·ses doivent cesser d’appeler ces points de terminaison et supprimer la dépendance. Aucune API ne remplace ces fonctionnalités.

Les points de terminaison représentatifs concernés sont les suivants :

• GET /{commerce-order-id} - Détails de la commande
• GET /{commerce-order-id}/items - Articles de la ligne de commande
• GET /{commerce-order-id}/payments - Order payments
• GET /{commerce-order-id}/payment_transaction_details - Détails de la transaction de paiement
• GET /{commerce-order-id}/refunds - Remboursements de la commande
• GET /{commerce-order-id}/shipments - Order shipments
• GET /{commerce-order-shipment-id}/items : articles de l’expédition
• GET /{commerce-return-id} - Détails du retour
• GET /{commerce-order-cancellation-id}/items - Cancellation line items
• GET /{page-id}/commerce_orders : répertorier les commandes par Page
• GET /{commerce-merchant-settings-id}/commerce_orders - Lister les commandes en fonction des paramètres du commerçant
• GET /{commerce-merchant-settings-id}/commerce_returns - Lister les retours en fonction des paramètres du commerçant
• GET /{commerce-merchant-settings-id}/tax_settings - Tax settings

La liste complète des 47 points de terminaison concernés sera disponible dans le changelog de la version 26.0 de l’API Graph.

API Graph : champs de propriétaire Rights Manager migrés vers RightsHolderOwner

Les champs reference_owner et matched_reference_owner sur AudioVisualReferenceMatch et ImageReferenceMatch, ainsi que les champs sending_rights_holder et receiving_rights_holder sur CopyrightOwnershipTransfer, vont bientôt être obsolètes. À partir de la version 26.0 de l’API Graph, des champs de remplacement renvoyant le type RightsHolderOwner dédié sont disponibles pour mieux représenter le modèle de propriété utilisé par Rights Manager. Les champs obsolètes ne sont plus renvoyés dans les réponses des versions 26.0 et ultérieures.

Les champs obsolètes continueront de fonctionner sur la version 25.0 et les versions antérieures pendant deux ans après le lancement de la version 26.0, après quoi ils seront supprimés. Les développeurs doivent migrer vers les champs de remplacement pendant cette période de deux ans.

Utilisez les champs de remplacement suivants :

• Utilisez reference_owner_rh_owner au lieu de reference_owner.
• Utilisez matched_reference_owner_rh_owner au lieu de matched_reference_owner.
• Utilisez sending_rights_holder_owner au lieu de sending_rights_holder.
• Utilisez receiving_rights_holder_owner au lieu de receiving_rights_holder.

Les points de terminaison représentatifs concernés sont les suivants :

• GET /{audio-visual-reference-match-id} - Détails de la correspondance de référence
• GET /{image-reference-match-id} - Détails de la détection de la référence d’image
• GET /{copyright-ownership-transfer-id} - Ownership transfer details

La liste complète des champs sera disponible dans le changelog de la version 26.0 de l’API Graph.

API Graph : les fonctionnalités de protocole obsolètes sont abandonnées

À partir du 29 juillet 2026, l’API Graph 26.0 et les versions ultérieures ne prendront plus en charge cinq comportements de protocole existants : pretty, debug, date_format, les requêtes GET /?ids=... racine et le traitement If-None-Match / ETag existant.

Ces comportements sont supprimés pour simplifier les réponses de l’API Graph et rendre le traitement des requêtes plus cohérent.

Pour l’API Graph v26.0 et versions ultérieures :

• pretty est ignoré, et les réponses JSON utilisent un format compact. Formater le JSON dans les outils client ou le code.
• debug est ignoré, et aucune enveloppe de réponse de débogage n’est ajoutée. Utilisez des outils de débogage standard. Le point de terminaison debug_token n’est pas affecté.
• Les requêtes incluant date_format renvoient une erreur de paramètre. Utilisez le format de date par défaut et convertissez les valeurs localement si nécessaire.
• Les demandes racines utilisant GET /?ids=... renvoient une erreur de paramètre. Utilisez des requêtes par objet ou des requêtes par lot prises en charge.
• If-None-Match est ignoré. Les en-têtes de réponse ETag existants et le comportement 304 Not Modified sont supprimés. Les requêtes renvoient des réponses complètes.

À compter du 27 octobre 2026, ces changements s’appliquent à toutes les versions de l’API Graph restantes prises en charge. Examinez les journaux des requêtes d’exécution et le changelog de l’API Graph v26.0 pour en savoir plus sur la migration.

Abandon des champs de Page hérités pour la nouvelle version des Pages (API Graph v26.0)

Brouillon de publication de blog pour les développeur·ses. Version cible : API Graph v26.0. Type de changement : abandon (90 jours).

Résumé

Pour les Pages utilisant la nouvelle version, cinq champs de nœud de Page hérités (current_location, genre, network, parking, start_info) et le paramètre de Page auto_publish_page_info_updates ne seront plus pris en charge à partir de la version 26.0 de l’API Graph. Ces champs ne sont plus mis à jour et ne doivent pas être utilisés dans le cadre de la nouvelle version des Pages.

Chronologie

• 29 juillet 2026 : Les champs sont bloqués et le paramètre est supprimé sur la version 26.0 et les versions ultérieures pour les Pages utilisant la nouvelle version des Pages.
• Environ 90 jours après le lancement : La même modification s’applique à toutes les versions restantes. La date exacte, qui se situe fin octobre 2026, doit être confirmée.

Ce qui change

Sur la version 26.0 et les versions ultérieures, une requête visant l’un de ces cinq champs sur une Page de la nouvelle version des Pages renvoie une erreur de version, et le paramètre auto_publish_page_info_updates n’apparaît plus dans la réponse des paramètres de Page. Sur les versions antérieures, le comportement reste inchangé jusqu’à la fin de la période de migration de 90 jours, après quoi les mêmes conditions s’appliquent à toutes les versions.

Points de terminaison concernés :

• GET /{page-id}?fields=current_location
• GET /{page-id}?fields=genre
• GET /{page-id}?fields=network
• GET /{page-id}?fields=parking
• GET /{page-id}?fields=start_info
• GET /{page-id}?fields=settings : le paramètre auto_publish_page_info_updates est supprimé de la liste des paramètres renvoyée

Ce que doivent faire les développeurs

• Supprimez ces champs et le paramètre auto_publish_page_info_updates de vos requêtes de Page.
• Vérifiez que vos journaux de requêtes, vos intégrations client et vos tableaux de bord n’utilisent pas ces champs sur les Pages de la nouvelle version des Pages.
• Consultez le changelog de la version 26.0 de l’API Graph pour obtenir la liste complète et à jour.

Référence

• Référence sur les nœuds de Page

API Marketing : critères d’audience Advantage+ pour les campagnes portant sur le logement, l’emploi, et les produits et services financiers

À compter du 29 juillet 2026, avec l’API Marketing v26.0, le paramètre advantage_audience dans targeting_automation sera automatiquement défini sur 1 pour les configurations d’audience entièrement par défaut ou assouplies. Pour les configurations d’audience restreintes, les développeur·ses doivent explicitement définir advantage_audience sur 1 ou 0 pour les campagnes des catégories publicitaires spéciales Logement, Emploi ou Produits et services financiers.

Ce comportement s’applique uniquement lors de la création d’un ensemble de publicités. La mise à jour d’un ensemble de publicités existant ne présentera pas ce comportement sur aucune version de l’API.

Ce comportement est le même que celui introduit pour les campagnes ne faisant pas partie des catégories publicitaires spéciales dans la version 23.0 de l’API Marketing. Consultez la documentation Résolution des problèmes liés à l’audience Advantage+ pour en savoir plus.

Les points de terminaison de l’API suivants sont concernés :

• POST /{ad-account-id}/adsets
• POST /{adset-id}
• POST /{adset-id}/copies

API Marketing : le placement Explorer n’est plus disponible

À compter du 29 juillet 2026, avec la version 26.0 de l’API Marketing, le placement Fil Explorer Instagram ne sera plus disponible. La diffusion dans Explorer s’arrêtera, et les dépenses de la campagne seront automatiquement transférées à d’autres placements éligibles.

Lorsque vous tenterez de créer ou de modifier un ensemble de publicités en sélectionnant le placement Explorer, vous obtiendrez un message d’erreur. Les développeur·ses doivent supprimer Explorer des configurations de placement et utiliser d’autres placements éligibles.

Les points de terminaison suivants sont concernés :

• POST /act_{ad-account-id}/adsets
• POST /{ad-set-id}

API Marketing : suppression des destinations uniquement Web pour les campagnes Web et application

À partir du 29 juillet 2026, avec l’API Marketing v26.0, les développeur·ses ne pourront plus joindre de contenu publicitaire avec applink_treatment défini sur web_only à une publicité dans une campagne qui utilise les lieux de conversion Site Web et Application. Cela a une incidence sur la création et les mises à jour de publicités via POST /act_{ad-account-id}/ads et POST /{ad-id}.

Le point de terminaison Contenu publicitaire ne change pas, mais POST /act_{ad-account-id}/adcreatives est l’emplacement où la valeur applink_treatment est configurée. Les développeur·ses doivent examiner leurs intégrations pour applink_treatment=web_only et utiliser la sélection automatique de destination ou une autre destination manuelle compatible pour les campagnes de site Web et d’application.

Le 27 octobre 2026, 90 jours après la sortie de la version 26.0, cette restriction s’appliquera à toutes les versions de l’API Marketing. Consultez la documentation Publicité et Contenu publicitaire pour plus d’informations.

API Marketing : abandon du placement Stories Messenger

À compter du 29 juillet 2026, avec la version 26.0 de l’API Marketing, la valeur story dans messenger_positions ne sera plus disponible lors de la création ou de la mise à jour d’ensembles de publicités via les appels associés à la version 26.0 ou ultérieure.

Pour ces appels, story sera silencieusement retiré des spécifications de ciblage et n’apparaîtra plus dans les placements effectifs pour les ensembles de publicités nouveaux ou existants. Les données de ciblage historiques peuvent continuer à inclure story lorsqu’elles sont demandées via GET /{ad_set-id}?fields=targeting. Aucune erreur dédiée ne sera renvoyée, mais des erreurs de validation de placement standard peuvent s’appliquer si la suppression de story laisse une configuration de placement non valide.

Les points de terminaison suivants sont concernés :

• POST /act_{ad-account-id}/adsets
• POST /{ad_set-id}

Les développeurs et développeuses qui utilisent les placements manuels doivent supprimer story de messenger_positions. S’il s’agit de la seule valeur, supprimez le champ messenger_positions dans son intégralité et envisagez de supprimer messenger de publisher_platforms lorsqu’aucun autre placement Messenger, tel que marketing_messages, n’est utilisé. Aucune action n’est requise pour les placements Advantage+.

Ce changement concernant uniquement l’API n’a pas d’incidence sur le Gestionnaire de publicités. Les appels sans version et les appels à des versions antérieures à la version 26.0 ne sont pas affectés dans un premier temps. Le 27 octobre 2026, 90 jours après la sortie de la version 26.0, l’abandon s’appliquera à toutes les versions de l’API Marketing, y compris les appels sans version.

API Marketing : la création de publicités avec sondage a été abandonnée

À partir du 29 juillet 2026, avec la version 26.0 de l’API Marketing, les composants de sondage ne seront plus pris en charge lors de la création ou de la mise à jour de publicités et de contenus publicitaires. Le champ poll_spec et la valeur "poll" du champ type ne seront plus disponibles sous interactive_components_spec.

Les demandes visant à créer un contenu publicitaire de sondage ou à modifier une publicité pour en utiliser un seront rejetées. Les mises à jour d’une publicité existante qui ne modifient pas son contenu publicitaire, comme les modifications de statut, de budget ou de calendrier, peuvent se poursuivre.

Les points de terminaison suivants sont concernés :

• POST /{ad_account_id}/adcreatives
• POST /{ad_account_id}/ads
• POST /{ad_id}
• GET /{ad_account_id}/generatepreviews

Les développeurs doivent supprimer les champs relatifs aux sondages de leurs spécifications de contenu publicitaire et utiliser un contenu publicitaire qui ne contient pas de sondage. Les appels vers des versions antérieures à la version 26.0 et les appels sans version ne sont pas affectés dans un premier temps.

Le 27 octobre 2026, 90 jours après la sortie de la version 26.0, cet abandon s’appliquera à toutes les versions de l’API Marketing.

Version 26 du SDK Meta Business

La version 26 du SDK Meta Business sera publiée peu après la publication de la version 26 de l’API Graph. Cette version inclura des mises à niveau de dépendances, l’intégration de l’éditeur de paramètres de l’API Conversions, de nouvelles fonctionnalités d’API et l’abandon de l’API de gestion des commandes commerciales ainsi que de plusieurs fonctionnalités de protocole héritées.

Le SDK Business est désormais intégré à l’éditeur de paramètres de l’API Conversions open source. Vous pouvez tirer parti de cette nouvelle intégration pour améliorer la qualité de votre intégration de l’API Conversions. Fonctionnalités clés : génération automatique (limitée par les préférences des annonceurs) et amélioration des paramètres fbc, fbp, event_source_url, referrer_url, client_ip_address et normalisation/hachage automatique des informations personnelles identifiables pour les langues prises en charge. Pour en savoir plus, cliquez ici. L’API de gestion des commandes (47 points de terminaison) ne sera plus disponible et ne sera pas remplacée. Le placement publicitaire Fil Explorer Instagram a été supprimé et renvoie des erreurs s’il est spécifié. Le placement Stories Messenger est silencieusement supprimé de messenger_positions. Les publicités dans le statut WhatsApp obtiennent de nouvelles fonctionnalités, notamment la spécification de l’identité, le carrousel jusqu’à 10 fiches et l’optimisation des conversions hors site.

Dans le cadre de notre calendrier d’abandon sur deux ans pour les SDK de la plateforme, veuillez noter les abandons et arrêts de prise en charge à venir :

• Septembre 2026 : le SDK de la plateforme Facebook version 20.0 sera abandonné
• Janvier 2027 : la version 21.0 du SDK de la plateforme Facebook sera obsolète

Abandon de certaines versions d’API :

Dans le cadre du calendrier de gestion des versions de Facebook pour l’API Graph, veuillez noter les abandons prévus prochainement :

API Graph

• 24 septembre 2026 : abandon et retrait de la plateforme de la version 20 de l’API Graph.
• 21 janvier 2027 : abandon et retrait de la plateforme de la version 21.0 de l’API Graph.

Afin d’éviter toute interruption, migrez tous les appels vers la version la plus récente de l’API.