Plateforme Instagram
Revenir à : Français (France)
Ce document a été mis à jour.
La traduction en Français (France) n’est pas encore terminée.
Anglais mis à jour : 3 sept.

Contenu multimédia Instagram

Représente un album, une photo ou une vidéo Instagram (vidéo importée, vidéo en direct, vidéo créée avec l’application Instagram TV, reel ou story).

À partir du 3 juin 2024, vous pourrez utiliser le champ boost_eligibility_info comme moyen pratique et efficace de déterminer si les contenus multimédias peuvent être boostés en tant que publicité, et le champ boost_ads_list pour retracer les informations d’anciennes publicités Instagram boostées liées à la publicité. Consultez le blog pour plus d’informations. Disponible uniquement pour l’API Graph pour Instagram.

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.

Limites

  • Les champs qui renvoient des valeurs agrégées n’incluent pas les données générées par les publicités. Par exemple, comments_count compte les commentaires sur une photo, mais pas sur les publicités qui contiennent cette photo.
  • Les légendes n’incluent pas le symbole (@) excepté si l’utilisateur ou l’utilisatrice 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.

Syntaxe de la requête

GET https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Paramètres du chemin

Espace réservéValeur

<API_VERSION>

Version de l’API.

<IG_MEDIA_ID>

Obligatoire. ID du contenu multimédia à publier.

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

CléEspace réservéValeur

access_token

<ACCESS_TOKEN>

Obligatoire. Token d’accès utilisateur de l’utilisateur·ice de l’application

fields

<LIST_OF_FIELDS>

Liste de champs séparés par une virgule que vous souhaitez obtenir en réponse.

Champs

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

ChampDescription

boost_ads_list

Donne un aperçu des informations publicitaires Instagram associées au contenu multimédia organique. Cela inclut l’ID et le statut de diffusion des publicités. Disponible uniquement pour l’API Graph pour Instagram.

boost_eligibility_info

Champ donnant des informations sur l’éligibilité d’un contenu multimédia Instagram au boost en tant que publicité, et d’autres informations si le contenu multimédia n’est pas éligible. Disponible uniquement pour l’API Graph pour Instagram.

caption
Public

Légende. Les albums enfants sont exclus. De même, le symbole @ est exclu, sauf si l’utilisateur·ice de l’application peut également effectuer des tâches équivalentes à des tâches d’admin sur la Page Facebook connectée au compte Instagram utilisé pour créer la légende (API Graph pour Instagram uniquement).

comments_count
Public

Nombre de commentaires sur le contenu multimédia. Les commentaires associés à des albums d’enfants sont exclus du contenu de l’album et de sa légende. En revanche, les réponses aux commentaires sont incluses.

copyright_check_information.status

Renvoie des objets status et matches_found

Objets statusDescription

status

  • completed : le processus de détection est terminé
  • error : une erreur s’est produite pendant le processus de détection
  • in_progress : le processus de détection est en cours
  • not_started : le processus de détection n’a pas commencé

matches_found

Ce paramètre est défini sur l’une des valeurs suivantes :

  • false si la vidéo n’enfreint pas les droits d’auteur,
  • true si la vidéo enfreint les droits d’auteur

Si une vidéo enfreint les droits d’auteur, copyright_matches est renvoyé avec un tableau d’objets concernant le contenu soumis à des droits d’auteur, le moment où l’infraction se produit dans la vidéo et les actions entreprises pour atténuer l’infraction.

Objets copyright_matchesDescription

author

Auteur·ice de la vidéo protégée par des droits d’auteur

content_title

Nom de la vidéo protégée par des droits d’auteur

matched_segments

Tableau d’objets avec les paires clé/valeur suivantes : * duration_in_seconds : durée (en secondes) de l’infraction aux droits d’auteur * segment_type : AUDIO ou VIDEO * start_time_in_seconds : défini sur l’heure de début de la vidéo

owner_copyright_policy

Les objets suivants sont renvoyés :

  • name : nom de la politique de protection des droits d’auteur du ou de la titulaire des droits d’auteur

  • actions : tableau d’objets action avec les mesures d’atténuation prises, définies par la politique de protection des droits d’auteur du ou de la titulaire des droits d’auteur. Peut inclure des mesures d’atténuation différentes selon le lieu.

    • action : mesure d’atténuation prise contre la vidéo enfreignant les droits d’auteur. Les mesures d’atténuation entreprises peuvent différer en fonction du pays. Les valeurs possibles sont les suivantes :
      • BLOCK : la vidéo est bloquée et ne peut pas être vue par les audiences qui figurent dans le tableau geos
      • MUTE : la vidéo est mise en sourdine pour les audiences qui figurent dans le tableau geos

id
Public

ID du contenu multimédia.

is_comment_enabled

Indique si les commentaires sont activés ou désactivés. Les albums enfants sont exclus.

is_shared_to_feed
Public

Pour les reels uniquement. Quand la valeur renvoyée est true, indique que le reel peut apparaître à la fois dans l’onglet Fil et l’onglet Reels. Quand la valeur renvoyée est false, indique que le reel peut apparaître uniquement dans l’onglet Reels.

Aucune des deux valeurs ne détermine si le reel apparaît effectivement dans l’onglet Reels, car le reel peut ne pas respecter les critères d’éligibilité ou peut ne pas être sélectionné par notre algorithme. Consultez les caractéristiques des reels pour connaître les critères d’éligibilité.

like_count

Nombre de mentions J’aime sur le contenu, y compris les réponses aux commentaires. Les mentions J’aime sur le contenu d’albums enfants et sur les publications promues créées à partir du contenu multimédia sont exclues.


En cas de passage indirect de la requête par un autre point de terminaison ou d’élargissement de champ, le champ like_count est omis si le ou la propriétaire du contenu multimédia a masqué le nombre de J’aime.

media_product_type
Public

Emplacement de la publication du contenu multimédia. La valeur peut être AD, FEED, STORY ou REELS. Disponible uniquement pour l’API Graph pour Instagram.

media_type
Public

Type de contenu multimédia. La valeur peut être CAROUSEL_ALBUM, IMAGE ou VIDEO.

media_url
Public

URL du contenu multimédia.

Le champ media_url ne figure pas dans les réponses si le contenu multimédia comprend des éléments protégés par des droits d’auteur ou a fait l’objet d’un signalement pour cause de violation des droits d’auteur. Le son des reels peut être un exemple de contenu soumis à des droits d’auteur.

owner
Public

ID de l’utilisateur ou utilisatrice Instagram à l’origine du contenu. Celui-ci est uniquement renvoyé si l’utilisateur ou l’utilisatrice de l’application qui effectue la requête a également créé le contenu. Sinon, le champ username est renvoyé.

permalink
Public

URL permanente du contenu multimédia.

shortcode
Public

Raccourci vers le contenu multimédia.

thumbnail_url
Public

URL de l’image miniature du contenu multimédia. Uniquement disponible sur le contenu multimédia VIDEO.

timestamp
Public

Date de création au format ISO 8601 dans le fuseau UTC (valeur par défaut : UTC ±00:00).

username
Public

Nom de l’utilisateur ou de l’utilisatrice à l’origine du contenu multimédia.

Arêtes

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

ArêteDescription

children
Public.

Représente une collection d’objets Contenu multimédia Instagram sur un album Contenu multimédia Instagram.

collaborators

Représente une liste d’utilisateur·ices ajouté·es en tant que collaborateur·ices sur un objet Contenu multimédia Instagram. Disponible uniquement pour l’API Graph pour Instagram.

comments

Représente une collection de Commentaires Instagram sur un objet Contenu multimédia Instagram.

insights

Représente les indicateurs d’interaction sociale sur un objet Contenu multimédia Instagram. Disponible uniquement pour l’API Graph pour Instagram.

Exemple de requête cURL

Exemple de requête

curl -X GET \
  'https://graph.instagram.com/v21.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

Les vidéos en direct de type contenu multimédia Instagram ne sont pas prises en charge.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User access token

Host URL

graph.instagram.com

graph.facebook.com

Login Type

Business Login for Instagram

Facebook Login for Business

Permissions
  • instagram_business_basic
  • instagram_business_manage_comments
  • instagram_basic
  • instagram_manage_comments
  • pages_read_engagement
  • pages_show_list

If the app user was granted a role via the Business Manager on the Page connected to the targeted IG User, you will also need one of:

  • ads_management
  • business_management

Syntaxe de la requête

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

Paramètres du chemin

Espace réservéValeur

<API_VERSION>

Version de l’API.

<IG_MEDIA_ID>

Obligatoire. ID du contenu multimédia Instagram.

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

CléEspace réservéValeur

access_token

<ACCESS_TOKEN>

Obligatoire. Token d’accès Utilisateur de l’utilisateur ou l’utilisatrice de l’application.

comment_enabled

<BOOL>

Obligatoire. Définissez sa valeur sur true pour activer les commentaires ou sur false pour les désactiver.

Exemple de requête cURL

Exemple de requête

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

Exemple de réponse

{
  "success": true
}

Suppression

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