API Graph pour Instagram

Contenu multimédia en direct des utilisateur·ices Instagram

Représente du contenu multimédia Instagram composé d’un ensemble de vidéos en direct associé à un·e utilisateur·ice Instagram.

Création

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

Lecture

GET /{ig-user-id}/live_media

Récupérez un contenu multimédia Instagram composé d’un ensemble de vidéos en direct associé à un·e utilisateur·ice Instagram.

Limites

Seul le contenu multimédia Instagram dont les vidéos en direct sont en cours de diffusion au moment de la requête sera renvoyé.

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.

Conditions requises

TypeCondition requise

Tokens d’accès

Utilisateur·ice

Autorisations

instagram_basic
instagram_read_engagement
pages_read_engagement


Si un rôle a été attribué à l’utilisateur·ice de l’application via Business Manager sur la Page connectée à l’utilisateur·ice Instagram cible, 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-user-id}/live_media
  ?access_token={access-token}

Paramètres du chemin

Espace réservéValeur

{api-version}
Chaîne

Version de l’API.

{ig-user-id}
Obligatoire
Chaîne

ID utilisateur spécifique à une app de l’utilisateur·ice de l’application.

Paramètres de chaîne de requête

CléValeur

access_token
Obligatoire
Chaîne

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

fields
Liste d’éléments séparés par une virgule

Liste des champs de contenu multimédia Instagram séparés par une virgule que vous souhaitez renvoyer pour chaque contenu multimédia Instagram en direct dans les résultats.

since
Horodatage

Horodatage Unix ou valeur des données strtotime qui indiquent le début d’une plage de données temporelles. Consultez Pagination en fonction du temps.

until
Horodatage

Horodatage Unix ou valeur des données strtotime qui indiquent la fin d’une plage de données temporelles. Consultez Pagination en fonction du temps.

Réponse

Objet au format JSON contenant les données que vous avez demandées.

{
  "data": [],
  "paging": {}
}

Contenus de la réponse

PropriétéValeur

data

Tableau de contenu multimédia Instagram associé à un·e utilisateur·ice Instagram.

paging

Objet contenant des curseurs de pagination et des URL de récupération d’ensembles de données précédents/suivants.

Exemple de requête cURL

Demande

curl -X GET \
  'https://graph.facebook.com/v19.0/17841405822304914/live_media?fields=id,media_type,media_product_type,owner,username,comments&access_token=IGQVJ...'

Réponse

{
   "id":"90010498116233",
   "media_type":"BROADCAST",
   "media_product_type":"LIVE",
   "owner":{
      "id":"17841405822304914"
   },
   "username":"jayposiris",
   "comments":{
      "data":[
        {
            "hidden": false,
            "id": "17907364514064687",
            "like_count": 0,
            "media": {
                "id": "17892642502701087"
            },
            "text": "@jayposiris",
            "timestamp": "2021-08-17T21:23:07+0000",
            "username": "bztest0316_11",
            "from": {
                "id": "5895605157123796",
                "username": "bztest0316_11"
            }
        }
      ]
   }
}

Mise à jour

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

Suppression

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