Instagram 그래프 API

IG 사용자 라이브 미디어

IG 사용자에 대한 라이브 방송 IG 미디어의 컬렉션을 나타냅니다.

만들기

지원되지 않는 작업입니다.

읽기

GET /{ig-user-id}/live_media

IG 사용자에 대한 라이브 방송 IG 미디어의 컬렉션을 가져옵니다.

제한 사항

요청 시점에 방송되는 라이브 방송 IG 미디어만 반환됩니다.

시간 기반 페이지 매김

이 엔드포인트는 시간 기반 페이지 매김을 지원합니다. Unix 타임스탬프 또는 strtotime 데이터 값과 함께 since 및 until 쿼리 문자열 매개변수를 포함하여 시간 범위를 정의합니다.

요구 사항

유형요구 사항

액세스 토큰

사용자

권한

instagram_basic
instagram_read_engagement
pages_read_engagement


앱 사용자가 타겟 IG 사용자에 연결된 페이지에서 비즈니스 관리자를 통해 역할을 부여받은 경우 다음 중 하나가 필요합니다.


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 미디어에 대해 반환하고자 하는 IG 미디어 필드의 쉼표로 구분된 리스트.

since
타임스탬프

Unix 타임스탬프 또는 시간 기반 데이터 범위의 시작을 가리키는 strtotime 데이터 값. 시간 기반 페이지 매김을 참조하세요.

until
타임스탬프

Unix 타임스탬프 또는 시간 기반 데이터 범위의 끝을 가리키는 strtotime 데이터 값. 시간 기반 페이지 매김을 참조하세요.

응답

요청한 데이터가 포함된 JSON 형식의 개체.

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

응답 내용

속성값

data

IG 사용자에 대한 IG 미디어의 배열.

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

업데이트

지원되지 않는 작업입니다.

삭제

지원되지 않는 작업입니다.