Graph API для Instagram

Медиафайлы прямых эфиров для IG User

Представляет подборку объектов видео в прямом эфире IG Media объекта IG User.

Создание

Эта операция не поддерживается.

Чтение

GET /{ig-user-id}/live_media

Получает подборку объектов видео в прямом эфире IG Media объекта IG User.

Ограничения

Возвращаются только объекты видео в прямом эфире IG Media, которые транслируются на момент запроса.

Разбивка на страницы по времени

Эта конечная точка поддерживает разбивку на страницы по времени. Чтобы задать диапазон, добавьте в строку запроса параметры since и until с метками времени Unix или значениями strtotime.

Требования

ТипТребование

Маркеры доступа

Пользователь

Разрешения

instagram_basic
instagram_read_engagement
pages_read_engagement


Если пользователь приложения получил роль на Странице, связанной с целевым пользователем IG User, через Business Manager, также потребуется одно из следующих разрешений:


ads_management;
business_management.

Синтаксис запроса

GET https://graph.facebook.com/{api-version}/{ig-user-id}/live_media
  ?access_token={access-token}

Параметры пути

ЗаполнительЗначение

{api-version}
Строка

Версия API.

{ig-user-id}
Обязательный параметр
Строка

ID пользователя внутри приложения.

Параметры строки запроса

КлючЗначение

access_token
Обязательный
Строка

Маркер доступа пользователя приложения.

fields
Список значений через запятую

Разделенный запятыми список полей IG Media, которые нужно вернуть для каждого объекта IG Media, содержащего видео в прямом эфире, из списка результатов.

since
Метка времени

Метка времени в формате Unix или значение данных strtotime, указывающее на начало диапазона данных, выбираемых по времени. См. раздел Разбивка на страницы по времени.

until
Метка времени

Метка времени в формате Unix или значение данных strtotime, указывающее на конец диапазона данных, выбираемых по времени. См. раздел Разбивка на страницы по времени.

Ответ

Объект в формате JSON, содержащий запрошенные данные.

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

Содержимое ответа

СвойствоЗначение

data

Массив объектов IG Media объекта IG User.

paging

Объект, содержащий курсоры разбивки на страницы и URL получения следующего или предыдущего набора данных.

Пример запроса cURL

Запрос

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...'

Ответ

{
   "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"
            }
        }
      ]
   }
}

Обновление

Эта операция не поддерживается.

Удаление

Эта операция не поддерживается.