Conteneur Instagram

Représente un conteneur de contenu multimédia pour la création d’un objet multimédia Instagram.

Requirements

Instagram API with Instagram LoginInstagram API with Facebook Login

Access Tokens

  • Instagram User 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_content_publish
  • instagram_basic
  • instagram_content_publish
  • pages_read_engagement

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
  • ads_read

Création

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

Lecture

GET <HOST_URL>/<IG_CONTAINER_ID>

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

Syntaxe de la requête

GET <HOST_URL>/<API_VERSION>/<IG_CONTAINER_ID>
  ?fields=<LIST_OF_FIELDS>
  &access_token=<ACCESS_TOKEN>

Paramètres de la 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 <IG_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.instagram.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.