Contenu multimédia d’utilisateur·ice Instagram

Représente un ensemble d’objets IG Media (contenu multimédia Instagram) liés à un utilisateur ou une utilisatrice Instagram.

Création

POST /{ig-user-id}/media

• Créez un conteneur Instagram au format image, carrousel, story ou reel que vous utiliserez dans le processus de publication de contenus. Voir le guide de publication de contenu pour connaître l’intégralité des étapes de publication.

Limites

Limites d’ordre général

• Les conteneurs expirent au bout de 24 heures.
• Si la Page connectée au compte professionnel Instagram ciblé nécessite une autorisation de publication de page (PPA), cette PPA doit être effectuée, sinon la requête échouera.
• Si la Page connectée au compte professionnel Instagram ciblé nécessite une authentification à deux facteurs, l’utilisateur ou l’utilisatrice Facebook doit également effectuer cette authentification, sinon la requête échouera.
• La publication sur Instagram TV n’est pas prise en charge.

Limites concernant les reels

• Les reels ne peuvent pas apparaître dans les carrousels d’album.
• Les paramètres de confidentialité du compte sont respectés au moment de la publication. Par exemple, si l’option Autoriser le remix est activée, les remix seront activés sur les reels au moment de leur publication. Toutefois, les remix pourront être désactivés manuellement sur les reels publiés par le biais de l’application Instagram.
• L’identification des musiques n’est disponible que pour l’audio d’origine.

Limites des stories

• Les stories expirent au bout de 24 heures.
• Elles prennent en charge les URL de vidéo ou de reel, mais pas les deux à la fois.
• La publication de stickers (lien, sondage, localisation) n’est pas prise en charge.

Conditions requises

Caractéristiques de l’image

• Format : JPEG
• Taille de fichier : 8 Mo maximum
• Proportions : doivent se situer dans une plage comprise entre 4:5 et 1,91:1
• Largeur minimale : 320 (sera mise à l’échelle au minimum si nécessaire)
• Largeur maximale : 1 440 (sera mise à l’échelle au maximum si nécessaire)
• Hauteur : varie selon la largeur et les proportions
• Espace colorimétrique : sRGB. Les images utilisant d’autres espaces colorimétriques verront ces espaces convertis en sRGB.

Caractéristiques des reels

Voici les spécifications pour les reels :

• Conteneur : MOV ou MP4 (MPEG-4 Part 14), pas de listes d’édition, moov atom devant le fichier.
• Codec audio : AAC, fréquence d’échantillonnage maximale 48 kHz, 1 ou 2 canaux (mono ou stéréo).
• Codec vidéo : HEVC ou H264, balayage progressif, GOP fermé, sous-échantillonnage chromatique 4:2:0.
• Fréquence d’images : 23-60 images/seconde.
• Taille d’image :

  • Colonnes maximales (pixels horizontaux) : 1 920
  • Il est nécessaire d’avoir des proportions comprises entre 0,01:1 et 10:1 bien que nous recommandions 9:16 pour éviter les espaces vides ou à rogner.
• Débit vidéo : VBR, 25 Mbit/s maximum
• Débit audio : 128 Kbits/s
• Durée : 15 minutes maximum, 3 secondes minimum
• Taille de fichier : 1 Go maximum

Voici les spécifications de la photo de couverture d’un reel :

• Format : JPEG
• Taille du fichier : 8 Mo maximum
• Espace colorimétrique : sRGB. Les images qui utilisent d’autres espaces colorimétriques seront converties en sRGB.
• Proportions : nous recommandons 9:16 pour éviter les espaces vides ou à rogner. Si la proportion de l’image originale n’est pas 9:16, nous recadrons l’image et utilisons le rectangle 9:16 le plus au milieu comme photo de couverture du reel. Si vous partagez un reel dans votre fil, nous recadrons l’image et utilisons le carré 1:1 le plus au milieu comme photo de couverture de votre publication dans le fil.

Caractéristiques des images des stories

• Format : JPEG
• Taille de fichier : 8 Mo maximum.
• Proportions : nous recommandons 9:16 pour éviter les espaces vides ou à rogner
• Espace colorimétrique : sRGB. Les images utilisant d’autres espaces colorimétriques verront ces espaces convertis en sRGB

Caractéristiques des vidéos des stories

• Conteneur : MOV ou MP4 (MPEG-4 Part 14), pas de listes d’édition, moov atom devant le fichier
• Codec audio : AAC, fréquence d’échantillonnage maximale 48 kHz, 1 ou 2 canaux (mono ou stéréo).
• Codec vidéo : HEVC ou H264, balayage progressif, GOP fermé, sous-échantillonnage chromatique 4:2:0.
• Fréquence d’images : 23-60 images/seconde.
• Taille d’image :

  • Colonnes maximales (pixels horizontaux) : 1 920
  • Il est nécessaire d’avoir des proportions comprises entre 0,1:1 et 10:1 bien que nous recommandions 9:16 pour éviter les espaces vides ou à rogner
• Débit vidéo : VBR, 25 Mbit/s maximum
• Débit audio : 128 Kbit/s
• Durée : 60 secondes maximum, 3 secondes minimum
• Taille de fichier : 100 Mo maximum

Syntaxe de la requête

Conteneurs d’images

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &is_carousel_item={is-carousel-item}
  &caption={caption}
  &location_id={location-id}
  &user_tags={user-tags}
  &product_tags={product-tags}
  &access_token={access-token}

Conteneurs de reels

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=REELS
&video_url={reel-url}
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&cover_url={cover-url}
&audio_name={audio-name}
&user_tags={user-tags}
&location_id={location-id}
&thumb_offset={thumb-offset}
&share_to_feed={share-to-feed}
&access_token={access-token}

Conteneurs de carrousels

Conteneurs de carrousels uniquement. Pour créer des conteneurs d’éléments de carrousel, créez des conteneurs d’images ou de vidéos à la place (les reels ne sont pas pris en charge). Voir Publications carrousels pour connaître l’intégralité des étapes de publication.

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
?media_type=CAROUSEL
&caption={caption}
&share_to_feed={share-to-feed}
&collaborators={collaborator-usernames}
&location_id={location-id}
&product_tags={product-tags}
&children={children}
&access_token={access-token}

Conteneurs d’images des stories

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?image_url={image-url}
  &media_type=STORIES
  &access_token={access-token}

Conteneurs de vidéos des stories

POST https://graph.facebook.com/{api-version}/{ig-user-id}/media
  ?video_url={video-url}
  &media_type=STORIES
  &access_token={access-token}

Paramètres du chemin

Paramètres de chaîne de requête

Réponse

Objet au format JSON contenant un ID de conteneur Instagram que vous pouvez utiliser pour publier le conteneur.

L’importation de vidéos étant asynchrone, la réception de l’ID du conteneur ne garantit pas la réussite de l’importation. Pour vérifier qu’une vidéo a bien été importée, envoyez une requête au champ status_code sur le conteneur Instagram. Si la valeur est FINISHED, l’importation a réussi.

{
  "id":"{ig-container-id}"
}

Exemple de requête

POST graph.facebook.com/17841400008460056/media ?image_url=https//www.example.com/images/bronzed-fonzes.jpg &caption=#BronzedFonzes! &collaborators= [‘username1’,’username2’] &user_tags=[ { username:'kevinhart4real', x: 0.5, y: 0.8 }, { username:'therock', x: 0.3, y: 0.2 } ] 

Exemple de réponse

{
  "id": "17889455560051444"
}

Lecture

GET /{ig-user-id}/media

Renvoie tous les contenus multimédias Instagram liés à un utilisateur ou une utilisatrice Instagram.

Limites

• Renvoie un maximum de 10 000 médias les plus récents.
• Pour les contenus multimédias Instagram des stories non pris en charge, utilisez le point de terminaison GET /{ig-user-id}/stories à la place.

Conditions requises

Pagination en fonction du temps

Ce point de terminaison prend en charge la pagination en fonction du temps. Ajoutez les paramètres de chaîne de requête since et until avec l’horodatage Unix ou les valeurs strtotime pour définir une plage.

Exemple de requête

GET graph.facebook.com/17841405822304914/media 

Exemple de réponse

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    },
    {
      "id": "17869102915168123"
    }
  ]
}

Mise à jour

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

Suppression

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