Conteneur Instagram

Représente un conteneur de contenu multimédia pour la création d’une publication Instagram. Consultez le guide de publication de contenu pour connaître l’intégralité des étapes de publication.

Création

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

Lecture

GET /{instagram-container-id}

Permet d’obtenir des champs et des arêtes sur un conteneur Instagram.

Conditions requises

TypeDescription

Tokens d’accès

Utilisateur

Autorisations

instagram_basic
instagram_content_publish
pages_read_engagement


Si un rôle sur la Page a été attribué à l’utilisateur·ice de l’application via Business Manager, l’une des autorisations suivantes est également requise :


ads_management
business_management

Syntaxe de la requête

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

Paramètres de chaîne de requête

ParamètreValeur

access_token
Chaîne
obligatoire

Token d’accès Utilisateur de l’utilisateur·ice 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

Nom du champDescription

copyright_check_status

Utilisé pour déterminer si une vidéo importée enfreint les droits d’auteur. Les paires clés-valeurs renvoient :

  • matches_found défini sur l’une des valeurs suivantes :
    • true : la vidéo enfreint les droits d’auteur
    • false : la vidéo n’enfreint pas les droits d’auteur
  • status défini sur l’une des valeurs suivantes :
    • 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é

id

ID du conteneur Instagram, représenté dans des exemples de code comme {instagram-container-id}

status

Statut de la publication. Si status_code indique ERROR, cette valeur sera un sous-code d’erreur.

status_code

Statut de publication du conteneur. Valeurs possibles :


  • EXPIRED : le conteneur n’a pas été publié dans la limite de 24 heures et a expiré.
  • ERROR : l’exécution du processus de publication par le conteneur a échoué.
  • FINISHED : le conteneur et son objet multimédia sont prêts à être publiés.
  • IN_PROGRESS : le conteneur est en train d’exécuter le processus de publication.
  • PUBLISHED : l’objet multimédia du conteneur a été publié.

Arêtes

Il n’y a pas d’arêtes sur ce nœud.

Réponse

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

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

Exemple de requête

curl -X GET \
  'https://graph.facebook.com/17889615691921648?fields=status_code&access_token=IGQVJ...'

Exemple de réponse

{
  "status_code": "FINISHED",
  "id": "17889615691921648"
}

Mise à jour

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

Suppression

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