Introducing Facebook Graph API v12.0 and Marketing API v12.0
Aujourd’hui, nous mettons en ligne la version 12.0 des API Graph et Marketing de Facebook. Cette page détaille les modifications qui auront un impact sur notre communauté de développeurs. Parmi ces modifications, découvrez des annonces, des mises à jour concernant les produits, des rappels concernant d’anciennes versions et des notifications sur des abandons à grande échelle qui peuvent impacter l’intégration de vos applications dans notre plate-forme.
Consultez notre changelog pour obtenir une liste complète et détaillée de toutes les modifications.
Annonces et mises à jour générales
API Conversions : version minimale compatible avec les appels étendue
Rétrocompatibilité de l’API Graph pour les applications créées avec des tokens d’accès en un clic À compter de la version 12.0, les tokens d’accès créés à partir de l’onglet des paramètres de l’API Conversions dans le Gestionnaire d’évènements sont acceptés par toutes les versions disponibles de l’API Graph (cliquez ici pour voir les versions acceptées).
Notez que les appels effectués avec ces tokens vers une version abandonnée de l’API Graph seront automatiquement redirigés vers la version disponible la plus ancienne. Ce mécanisme s’applique uniquement aux points de terminaison de l’API Graph. Les points de terminaison de l’API Marketing, y compris de l’API Conversions, n’effectuent pas cette redirection automatique et renvoient une exception.
API User Profile pour la messagerie Instagram : nouveaux champs
Nous apportons des améliorations à l’API User Profile pour la messagerie Instagram. Auparavant, l’API User Profile pour Instagram acceptait deux champs : 1) Nom et 2) URL de la photo de profil. Afin de permettre aux entreprises de personnaliser davantage et de prioriser les messages en fonction des informations publiques des utilisateurs, nous avons mis à jour l’API de sorte qu’elle intègre les données suivantes :
1. Nombre d’abonnés
2. Badge Vérifié
3. Compte utilisateur suivi par l’entreprise [Oui/Non]
4. Compte business suivi par l’utilisateur [Oui/Non]
Pour en savoir plus, consultez la documentation pour les développeurs.
Nouvelles opportunités avec le ciblage détaillé
Quand les annonceurs utiliseront le ciblage détaillé et procèdent à des optimisations avec l’objectif Conversions pour les évènements d’application, de conversion ou de valeur, ils seront automatiquement inclus dans l’extension du ciblage. Les annonceurs pourront ainsi trouver de nouvelles opportunités auxquelles ils n’avaient pas accès auparavant. Pour en savoir plus, consultez l’article À propos de l’extension du ciblage de nos pages d’aide.
API Video : nouveaux champs
Le nœud [Video] s’enrichit de deux nouveaux champs : views et post_views. Pour en savoir plus, consultez la documentation pour les développeurs sur l’API Video.
Abandons et modifications importantes
Transparence des erreurs
En temps normal, les API Graph et Marketing renvoient par défaut une erreur quand une application demande un champ ou une arête sur un nœud qui renvoie un ou plusieurs nœuds associés, pour lesquels l’application ne dispose pas des autorisations requises. Toutefois, plusieurs de ces champs et arêtes ne suivaient pas ce protocole et étaient simplement omis des réponses de l’API quand l’application à l’origine de l’appel ne disposait pas des autorisations requises.
À compter de la version 12.0, ces champs et arêtes suivront la procédure par défaut. Cette modification sera appliquée à toutes les versions le 13 décembre 2021.
Utilisateurs système et rôles de l’application
Les utilisateurs système ne peuvent plus obtenir de rôles dans les applications qui n’appartiennent pas à leur entreprise. Afin d’éviter toute perturbation de votre application et de votre entreprise, nous vous recommandons de supprimer les utilisateurs système concernés de votre application et d’utiliser l’API Business On Behalf Of à la place. Cette modification importante prendra effet le 13 décembre 2021.
Direct programmé
Nous abandonnons le paramètre planned_start_time de la fonctionnalité de programmation dans l’API Live. Cette modification importante prendra effet le 13 décembre 2021. Nous annoncerons ultérieurement le lancement d’un nouveau paramètre.
Plate-forme Messenger : API Conversation
Nous abandonnons le champ user_id dans les métadonnées des fils de discussion de l’API Conversation. Tous les développeurs doivent migrer les références à user_id (ID Instagram) et utiliser uniquement l’ID spécifique à Instagram (IGSID) comme identifiant principal d’un fil de discussion entre un utilisateur et une entreprise.
Cette modification importante sera appliquée aux anciennes versions de l’API Graph le 13 décembre 2021. Pour en savoir plus, consultez la documentation pour les développeurs sur l’API Conversation.
Plate-forme Messenger : webhooks Instagram
Nous apportons une mise à jour au webhook des réactions Instagram de notre API Messenger afin d’améliorer la prise en charge des réactions emoji. Dans la version actuelle, le champ emoji est renvoyé sous forme d’une chaîne. Avec cette mise à jour, les webhooks renvoient un nouveau format Unicode. Notez que le champ « reaction » n’acceptera que les emojis par défaut. Pour les autres emojis, ce champ renverra « other », comme MSGR.
Cette modification importante sera appliquée aux anciennes versions de l’API Graph à partir du 13 décembre 2021. Pour continuer à prendre en charge les réactions emoji, tous les développeurs doivent migrer vers le nouveau format Unicode avant le 13 décembre 2021. Pour en savoir plus, consultez la documentation pour les développeurs sur les webhooks.
Abandon de certaines versions d’API :
Dans le cadre du calendrier de gestion des versions de Facebook pour l’API Graph et l’API Marketing, veuillez noter les abandons prévus prochainement :
API Graph
- 2 novembre 2021 : abandon et retrait de la plate-forme de la version 4.0 de l’API Graph
- 3 février 2022 : abandon et retrait de la plate-forme de la version 5.0 de l’API Graph
- 22 mai 2022 : abandon et retrait de la plate-forme de la version 6.0 de l’API Graph
Pour éviter tout désagrément pour votre entreprise, nous vous recommandons de migrer tous les appels vers la version la plus récente de l’API que nous avons lancée aujourd’hui.
API Marketing
- La version 10.0 de l’API Marketing sera abandonnée le 4 octobre 2021
- La version 11.0 de l’API Marketing sera abandonnée le 23 février 2022
Pour éviter tout désagrément pour votre entreprise, nous vous recommandons de migrer tous les appels vers la version la plus récente de l’API Marketing que nous avons lancée aujourd’hui. (Pour en savoir plus, consultez le changelog.)
SDK de la plate-forme Facebook
- Le 19 janvier 2021, nous annoncions le calendrier d’abandon sur deux ans des versions 8.x et antérieures du SDK de la plate-forme Facebook. Ces versions seront abandonnées en janvier 2023.
- Le 8 juin 2021, nous lancions la version 11.0 du SDK de la plate-forme Facebook, qui marquait le début du calendrier d’abandon de la version 9.0 du SDK. Cette version 9.0 sera abandonnée en juin 2023.
Abandons généraux
Abandon des points de terminaison des offres natives
Le 8 juin 2021, nous annoncions l’abandon de l’API Offers Ads. Cet abandon prendra effet immédiatement après le lancement de la version 12.0 de l’API Graph.
Plate-forme Messenger : modèles pour les compagnies aériennes
Le 8 juin 2021, nous annoncions l’abandon des modèles pour les compagnies aériennes. Cet abandon prendra effet le 6 décembre 2021.
