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}
必須
文字列

アプリユーザーのapp-scoped user 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"
            }
        }
      ]
   }
}

更新

この操作はサポートされていません。

削除

この操作はサポートされていません。