Contenu multimédia Instagram

Représente un album, une photo ou une vidéo Instagram (vidéo importée, vidéo en direct, reel ou story).

Vue d’ensemble du champ suivant :

• legacy_instagram_media_id

Les champs du point de terminaison Publicités Instagram de l’API Marketing ne sont pas pris en charge :

• filter_name
• location
• location_name
• latitude
• longitude

Création

Cette opération n’est pas prise en charge.

Lecture

GET /<IG_MEDIA_ID>

Obtenir les champs et les arêtes d’un contenu multimédia Instagram.

Conditions requises

Limites

• Les champs tels que comments_count et like_count renvoient des interactions sur le contenu multimédia Instagram cible uniquement et n’incluent pas les données des autres plateformes. Par exemple, comments_count renvoie le nombre de commentaires sur une photo, mais pas sur les publicités contenant cette photo. Utilisez total_comments_count et total_like_count pour obtenir des comptages agrégés qui incluent les interactions avec les contenus multimédias promus/boostés/publicitaires. Le nombre de publications Facebook crosspostées peut être inclus si ces publications sont accessibles par l’utilisateur·ice de la session.
• Les légendes n’incluent pas le symbole @ sauf si l’utilisateur·ice de l’application peut également exécuter des tâches équivalentes à des tâches d’admin dans l’application.
• Certains champs, tels que permalink, ne peuvent pas être utilisés sur les photos présentes dans les albums (enfants).
• Le contenu multimédia Instagram de type vidéo en direct ne peut être lu que pendant sa diffusion.
• Cette API renvoie uniquement les données de contenu multimédia détenu par des comptes professionnels Instagram. Elle ne permet pas de récupérer des données de contenu multimédia détenu par des comptes personnels Instagram.
• Les champs reposts_count, saved_count, shares_count, total_like_count, total_comments_count et total_views_count ne sont pas disponibles pour les contenus multimédias enfants du carrousel et sont uniquement renvoyés pour les objets multimédias de premier niveau. Le ou la propriétaire du contenu multimédia peut désactiver l’affichage des mentions J’aime, des commentaires, des vues, des republications et des partages. Dans ce cas, les champs correspondants ne sont pas renvoyés.

Syntaxe de la requête

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

Paramètres du chemin

Paramètres de la chaîne de requête

Champs

Champs publics qui peuvent être vus avec l’élargissement de champ.

Arêtes

Arêtes publiques qui peuvent être retournées via l’élargissement de champ.

Exemple de requête cURL

Exemple de requête

curl -X GET \
  'https://graph.instagram.com/v26.0/17895695668004550?fields=id,media_type,media_url,owner,timestamp&access_token=IGQVJ...'

Exemple de réponse

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

Mise à jour

POST /<IG_MEDIA_ID>

Active ou désactive les commentaires sur un contenu multimédia Instagram.

Limites

Contenu multimédia Instagram de type vidéo en direct non pris en charge.

Syntaxe de la requête

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

Paramètres du chemin

Paramètres de la chaîne de requête

Exemple de cURL

Exemple de requête

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Exemple de réponse

{
  "success": true
}

Suppression

DELETE /<IG_MEDIA_ID>

Supprimez le contenu multimédia Instagram.

Conditions requises

Limites

Cette API prend uniquement en charge l’API Instagram avec une connexion Facebook. Les publications non publicitaires, les stories, les reels et les albums carrousel complets sont pris en charge. Pour supprimer des contenus multimédias d’un album carrousel, vous devez supprimer l’album entier en spécifiant l’ID du contenu multimédia du conteneur carrousel. La suppression individuelle de contenus multimédias au sein d’un carrousel n’est pas prise en charge.

Syntaxe de la requête

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

Paramètres du chemin

Paramètres de la chaîne de requête

Exemple de cURL

Exemple de requête

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

Exemple de réponse (réussite)

{
  "success": true,
  "deleted_id": "17918920912340654"
}

Exemple de réponse (échec, type de contenu multimédia non pris en charge)

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}