Plate-forme Instagram

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).

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 Instagram TV doit être partagé sur Instagram lors de sa publication (option Publier un aperçu ou Partager l’aperçu dans le fil activée) afin d’être accessible via l’API.
  • Le contenu multimédia Instagram de type vidéo en direct ne peut être lu que pendant sa diffusion.

Conditions requises

TypeDescription

Tokens d’accès

Utilisateur.

Autorisations

instagram_basic
pages_read_engagement
pages_show_list


Si un rôle sur la Page a été attribué à l’utilisateur·ice de l’application via Business Manager, vous aurez également besoin de l’un des éléments suivants :


ads_management
business_management

Syntaxe de la requête

GET https://graph.facebook.com/{api-version}/{ig-media-id}
  ?fields={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 Instagram.

Paramètres de chaîne de requête

CléEspace réservéValeur

access_token

{access-token}

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

fields

{fields}

Liste de champs séparés par une virgule que vous souhaitez voir renvoyés.

Champs

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

ChampDescription

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.

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.

ig_id
Public

ID du contenu multimédia Instagram. Utilisé avec l’ancienne API Instagram, désormais obsolète. Utilisez plutôt id.

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.


Si la requête est effectuée indirectement par l’intermédiaire d’un autre point de terminaison ou élargissement de champ :


  • Appels vers la version 10.0 et antérieures : renvoie la valeur 0 si le propriétaire du contenu multimédia possède des mentions J’aime masquées.
  • Appels vers la version 11.0 et ultérieures : le champ like_count est omis si le nombre de mentions J’aime a été masqué par le propriétaire du contenu multimédia.

media_product_type
Public

Emplacement de la publication du contenu multimédia. La valeur peut être AD, FEED, STORY ou REELS.

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 utilisatrice à l’origine du contenu multimédia.

video_title
Public

Obsolète. Omis dans la réponse.

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.

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.

Exemple de requête cURL

Demande

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

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.

Conditions requises

TypeDescription

Tokens d’accès

Utilisateur.

Autorisations

instagram_basic
instagram_manage_comments
pages_show_list


Si un rôle sur la Page a été attribué à l’utilisateur·ice de l’application via Business Manager, vous aurez également besoin de l’un des éléments suivants :


ads_management
business_management

Syntaxe de la requête

POST https://graph.facebook.com/{api-version}/{ig-media-id}
  ?comment_enabled={comment-enabled}
  &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 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

{comment-enabled}

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

Exemple de requête cURL

Demande

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

Réponse

{
  "success": true
}

Suppression

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