Changelog

Ce changelog fait référence aux modifications apportées pour l’API Graph pour Instagram

Changelogs connexes

12 septembre 2023

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

9 novembre 2022

Webhooks Instagram

S’applique à toutes les versions.

Les valeurs ad_id et ad_title sont renvoyées dans l’objet media de l’objet value du champ comments lorsqu’une personne commente une publication Instagram boostée ou une publication de publicités Instagram.

31 octobre

Reels – Tags de produits

S’applique à toutes les versions.

L’API Instagram Product Tagging pour Reels est disponible. Vous pouvez identifier jusqu’à 30 produits lors de la publication d’un reel.

28 juin 2022

Reels

Concerne toutes les versions.

Les reels sont désormais pris en charge. Pour publier une vidéo sous forme de reel, attribuez au paramètre media_type la valeur REELS lors de la création d’un conteneur de publications d’un seul contenu multimédia. Consultez la référence POST /ig-user/media endpoint pour connaître les paramètres pouvant être utilisés avec les reels, ainsi que les conditions requises pour les vidéos de reels.

27 juin 2022

Documentation sur l’ancienne API Instagram

Concerne toutes les versions.

La documentation développeur sur l’ancienne API Instagram a été supprimée et renvoie désormais vers la documentation développeur sur la plateforme Instagram.

20 juin 2022

Identification de produits

Concerne toutes les versions.

Vous pouvez désormais créer et gérer des tags de produit liés à la Boutique Instagram dans les contenus multimédias publiés d’Instagram Business. Pour en savoir plus, consultez le guide Identification de produits.

27 mai 2022

Variantes du produit

S’applique à toutes les versions.

Pour les partenaires qui utilisent la version bêta de l’identification de produits, toutes les variantes du produit qui correspondent aux critères de recherche d’une demande seront à présent renvoyées si vous réalisez une recherche de produits dans un catalogue.

15 mars 2022

Publications au format carrousel

Concerne toutes les versions.

Vous pouvez maintenant utiliser l’API Instagram pour publier des publications contenant plusieurs images et vidéos (publications au format carrousel). Consultez le guide de publication de contenu pour connaître l’intégralité des étapes de publication.

Si votre application a déjà été approuvée concernant les autorisations requises pour la publication de contenu, il est inutile de procéder à nouveau à un Contrôle app pour profiter de cette fonctionnalité.

9 novembre 2021

Vidéos en direct

Concerne toutes les versions.

Vous pouvez maintenant utiliser l’API Instagram pour permettre aux utilisateurs de votre application de diffuser des vidéos en direct IG Media, récupérer les commentaires ajoutés à ces vidéos et utiliser l’API Instagram Messaging pour envoyer des réponses privées (messages directs) aux auteurs de ces commentaires. Pour prendre en charge cette fonctionnalité, nous avons apporté les modifications suivantes :

  • une nouvelle arête GET /ig-user/live_media peut renvoyer la vidéo en direct IG Media en cours de diffusion par l’utilisateur de votre application au moment de la requête ;
  • le champ media associé à un commentaire Instagram renvoie désormais un objet contenant à la fois l’ID (id) et le lieu de publication (media_product_type) du contenu multimédia sur lequel le commentaire a été effectué ;
  • un nouveau champ Webhooks Instagram live_comments peut envoyer des notifications contenant les commentaires en direct ajoutés aux vidéos en direct des utilisateurs de votre application au moment de leur diffusion.

Reportez-vous à la documentation relative aux réponses de l’API Instagram Messaging pour découvrir comment envoyer des réponses privées aux utilisateurs qui ont commenté les vidéos en direct IG Media des utilisateurs de votre application.

20 octobre 2021

Commentaires Instagram

Concerne toutes les versions.

Deux nouveaux champs ont été ajoutés aux commentaires Instagram :

  • from : renvoie un objet contenant l’ IGSID (id) et le nom d’utilisateur (username) de l’auteur du commentaire.
  • parent_id : renvoie l’ID du commentaire Instagram parent si le commentaire a été créé sur un autre commentaire Instagram (réponse à un autre commentaire, par exemple).

Webhooks Instagram

Concerne toutes les versions.

Le champcomments des webhooks Instagram inclut désormais les propriétés suivantes dans l’objet du champ value :

  • from.id : IGSID de l’utilisateur Instagram qui a créé le commentaire.
  • from.username : nom d’utilisateur Instagram qui a créé le commentaire.
  • media.id : ID de l’objet IG Media sur lequel le commentaire a été effectué.
  • media.media_product_type : surface (lieu de publication) de l’objet IG Media sur lequel le commentaire a été effectué.
  • parent_id : ID du commentaire Instagram parent si le commentaire a été créé sur un autre commentaire Instagram (réponse à un autre commentaire, par exemple).

5 octobre 2021

Les modifications suivantes s’appliquent aux vidéos Instagram TV créées le 5 octobre 2021 ou après cette date. Les vidéos Instagram TV créées avant cette date ne sont pas concernées par ces modifications.

  • Le champmedia_product_type renverra FEED au lieu de IGTV.
  • Le champvideo_title ne sera pas renvoyé.
  • Les webhooks pour Instagramcomments et les champs mentions sont désormais pris en charge.

Le 3 janvier 2022, les modifications ci-dessus s’appliqueront à toutes les versions des API et toutes les vidéos Instagram TV, quelle que soit la date de création de la vidéo. Par conséquent, à partir du 3 janvier 2022, les applications utilisant les versions d’API plus anciennes pourront interroger les vidéos Instagram TV (compatibilité de lecture intégrée dans la version 10.0 et limitée aux versions ultérieures).

À partir de la version 14.0, le champ video_title n’est plus pris en charge et l’API renverra une erreur en cas de requête sur ce champ.

8 juin 2021

Nombre de mentions J’aime

Concerne la version 11.0 et les versions ultérieures. Toutes les autres versions seront concernées à partir du 7 septembre 2021.

Si vous interrogez un objet IG Media 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 IG Media 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 ulté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.

26 mai 2021

Si vous interrogez un objet IG Media de manière indirecte par le biais d’un autre point de terminaison, le champ like_count renvoie la valeur 0 si l’utilisateur de l’application ne possède pas le contenu multimédia et que son propriétaire contient des mentions J’aime masquées. Si vous interrogez l’objet IG Media 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 le propriétaire a des mentions J’aime masquées sur le contenu multimédia.

4 mai 2021

Nous avons légèrement modifié la façon de calculer l’indicateur online_followers pour les Utilisateurs IG.

14 avril 2021

Les interactions IG Media de stories effectuées par des utilisateurs au Japon ne sont plus prises en compte dans certains calculs d’indicateurs replies :

  • Pour les stories créées par des utilisateurs au Japon, l’indicateur replies renverra désormais la valeur 0.
  • Pour les stories créées par des utilisateurs hors du Japon, l’indicateur replies renverra le nombre de réponses, mais les réponses des utilisateurs au Japon ne seront pas prises en compte dans ce calcul.

12 avril 2021

Correction d’un bug mineur concernant les indicateurs de couverture sur un contenu IG Media de story.

9 avril 2021

  • Le champ status d’un Conteneur IG renvoie désormais un sous-code d’erreur si la valeur du champ error_code du conteneur est ERROR.
  • L’indicateur Insights sur les médias IGvideo_views prend désormais en charge les albums et renverra la somme des video_views de toutes les vidéos de l’album au lieu de 0.

16 mars 2021

Les contenus IGTV sont désormais pris en charge dans la version 10.0 et versions ultérieures. Cela concerne tous les points de terminaison à l'exception de ceux utilisés pour la publication de contenu et les webhooks. En complément de cette modification, les champs media_product_type et video_title ont été ajoutés au nœud IG Media. Les contenus IGTV doivent être partagés sur Instagram lors de leur publication (option Publier un aperçu ou Partager l’aperçu sur le fil d’actualité) afin d’être accessibles via l’API.

26 janvier 2021

La version bêta de la publication de contenu est désormais terminée et la totalité des développeur·ses peut publier du contenu sur des comptes professionnels Instagram. Reportez-vous au guide sur la publication de contenu pour en savoir plus sur cette fonctionnalité.

2 décembre 2020

Conformément à la Directive ePrivacy de l’Union européenne, les interactions des utilisateur·ices de l’Espace économique européen (EEE) avec un objet IG Media (contenu multimédia Instagram) de stories liées à la messagerie après le 1ᵉʳ décembre 2020 ne seront plus prises en compte dans certains calculs d’indicateurs :

  • Pour les stories créées par des utilisateur·ices de l’EEE, l’indicateur replies renverra désormais la valeur 0.
  • Pour les stories créées par des utilisateur·ices hors de l’EEE, l’indicateur replies renverra le nombre de réponses, mais les réponses des utilisateur·ices de l’EEE ne seront pas prises en compte dans ce calcul.

Cette modification s’applique à toutes les versions.

10 novembre 2020

  • Insights d’utilisateur IG : les valeurs follower_count correspondent davantage aux valeurs correspondantes affichées dans l’app Instagram. De plus, les valeurs follower_count renvoient désormais un maximum de 30 jours de données, contre deux ans auparavant. Cette modification s’applique aux versions 9.0 et ultérieures, et s’appliquera à toutes les versions le 9 mai 2021.

5 mai 2020

3 décembre 2019

  • Insights : les insights concernant les Utilisateurs IG ne sont maintenant disponibles que pour les utilisateurs et utilisatrices Instagram qui possèdent au moins 100 abonnés afin d’aligner le comportement de l’API avec celui de l’application Instagram.

13 août 2019

  • Découvrir des entreprises : l’API Découvrir des entreprises peut maintenant être utilisée pour obtenir des données sur d’autres comptes Creator Instagram.

22 mai 2019

9 mai 2019

  • Webhooks : le champ story_insights requiert désormais l’autorisation instagram_manage_insights au lieu de instagram_manage_comments.

31 octobre 2018

  • API Recherche de hashtags : vous pouvez désormais rechercher du contenu comportant des hashtags spécifiques à l’aide de notre nouvelle API Recherche de hashtags. #spooky !

23 octobre 2018

  • Arête /{ig-media-id}/comments : les demandes GET effectuées à l’aide de l’API version 3.1 ou antérieure renvoient les résultats dans l’ordre chronologique. Les résultats des demandes effectuées à l’aide de l’API version 3.2 ou ultérieure seront renvoyés dans l’ordre chronologique inverse.

7 juin 2018

  • Nœud /{ig-media-id} : vous pouvez désormais utiliser l’extension de champ pour obtenir le champ permalink sur des médias.

1ᵉʳ mai 2018

  • Vérification de l’entreprise : afin d’utiliser l’API Graph pour Instagram, toutes les apps doivent faire l’objet d’une vérification de l’entreprise, qui fait partie du processus de Contrôle app et est désormais requise pour tous les points de terminaison de l’API Graph pour Instagram. Les apps précédemment contrôlées avant le 1er mai 2018 doivent être à nouveau contrôlées et ont jusqu’au 1er août 2018 au risque de perdre l’accès à l’API.

24 avril 2018

  • Nœud /{ig-comment-id} :
    • Ajout d’un nouveau champ username.
    • Pour les requêtes GET, le champ user n’est pas inclus dans les réponses sauf si l’utilisateur·ice à l’origine de la demande possède le commentaire ; sinon le champ username sera renvoyé à toutes les personnes ayant saisi des commentaires. Ceci s’applique également aux requêtes sur des commentaires ayant été effectuées par le biais d’autres API, par exemple l’API Mentions.
  • Nœud /{ig-media-id} :
    • Ajout d’un nouveau champ username.
    • Pour les requêtes GET, le champ owner n’est pas inclus dans les réponses sauf si l’utilisateur·ice à l’origine de la demande possède l’objet média ; sinon le champ username sera renvoyé à toutes les personnes ayant saisi des commentaires. Ceci s’applique également aux requêtes sur des objets média ayant été effectuées par le biais d’autres API, par exemple l’API Mentions.

23 avril 2018

  • API Insights : les insights incluront désormais l’activité publicitaire générée par le biais de l’API, les interfaces de publicités Facebook et la fonctionnalité Promouvoir d’Instagram. Les indicateurs suivants sont concernés :

    • impressions
    • reach

13 mars 2018

  • API Publication de contenu : les partenaires en version bêta peuvent maintenant utiliser l’arête /{ig-user-id}/media pour identifier des lieux et des utilisateur·ices Instagram public·ques lorsqu’ils publient des photos.

8 mars 2018

  • Champs publics : le champ timestamp sur le nœud /{ig-media-id} est désormais public et peut être renvoyé via l’extension de champ.

22 février 2018

  • Champs publics : les nœuds /{ig-user-id}, /{ig-comment-id} et /{ig-media-id} renvoient désormais tous les champs publics en cas d’accès via une arête utilisant l’extension de champ. Reportez-vous au document de référence de chaque nœud pour savoir quels champs sont publics.

8 février 2018

  • API Publication de contenu : les partenaires en version bêta peuvent désormais inclure des hashtags lorsqu’ils publient des photos par le biais de l’arête /{ig-user-id}/media. #crazywildebeest !