Contenu multimédia

Représente une image, une vidéo ou un album.

Création

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

Lecture

GET /{media-id}

Obtient des champs et des arêtes sur une image, une vidéo ou un album.

Conditions requises

Type	Condition requise
Tokens d’accès	Utilisateur Instagram
Autorisations	`instagram_graph_user_media`

Syntaxe de la requête

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

Paramètres de chaîne de requête

Inclure les paramètres de chaîne de requête suivants pour augmenter la demande.

Clé	Valeur
`access_token` Obligatoire Chaîne	Token d’accès pour utilisateur Instagram de l’utilisateur de l’application.
`fields` Liste d’éléments séparés par une virgule	Liste des arêtes et des champs (séparés par des virgules) à renvoyer. En cas d’omission, les champs par défaut sont renvoyés.

Champs

Vous pouvez utiliser le paramètre de chaîne de requête fields pour demander les champs suivants sur un contenu multimédia.

Nom du champ	Description
`caption`	Texte de légende du contenu multimédia. Ne peut pas être renvoyé pour les contenus multimédia d’albums.
`id`	ID du contenu multimédia.
`is_shared_to_feed`	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. Voir les caractéristiques des reels pour connaître les critères d’éligibilité.
`media_type`	Type du contenu multimédia. La valeur peut être `IMAGE`, `VIDEO` ou `CAROUSEL_ALBUM`.
`media_url`	URL du contenu multimédia.
`permalink`	URL permanente du contenu multimédia. Ne sera pas précisée 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.
`thumbnail_url`	URL de l’image miniature du contenu multimédia. Uniquement disponible sur le contenu multimédia `VIDEO`.
`timestamp`	Date de publication du contenu multimédia au format ISO 8601.
`username`	Nom d’utilisateur du propriétaire du contenu multimédia.

Arêtes

Vous pouvez interroger les arêtes suivantes en tant que paramètres du chemin ou en utilisant le paramètre de chaîne de requête fields.

Arête	Description
`children`	Obtient une liste de contenus multimédia sur les contenus multimédia d’albums. Uniquement disponible sur le contenu multimédia `CAROUSEL_ALBUM`.

Réponse

Objet au format JSON contenant des arêtes et des champs demandés et par défaut.

{
  "{field}":"{value}",
  ...
}

Exemple de cURL

Demande

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

Réponse

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

Mise à jour

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

Suppression

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