IG 用戶直播影音素材

代表 IG 用戶的直播視訊 IG 影音素材集合。

建立

不支援執行此作業。

讀取

GET /{ig-user-id}/live_media

取得 IG 用戶的直播影片 IG 影音素材集合。

限制

系統只會傳回要求時正在直播的直播影片 IG 影音素材。

時間型分頁

此端點支援時間型分頁。包含 since 和 until 查詢字串參數並搭配 Unix 時間戳記或 strtotime 資料值，以定義時間範圍。

必備條件

類型條件

類型	條件
存取權杖	用戶
權限	`instagram_basic` `instagram_read_engagement` `pages_read_engagement` 如果應用程式用戶是透過連結至目標 IG 用戶之粉絲專頁的企業管理平台獲得角色，您還需要下列其中一項： `ads_management` `business_management`

存取權杖

用戶

權限

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}` 必要字串	應用程式用戶的應用程式範圍用戶編號。

查詢字串參數

索引鍵	值
`access_token` 必要字串	應用程式用戶的用戶存取權杖。
`fields` 逗號分隔清單	在結果集中，您想傳回的每個直播 IG 影音素材之 IG 影音素材欄位的逗號分隔清單。
`since` 時間戳記	指向以時間為基礎的資料範圍開頭的 Unix 時間戳記或 `strtotime` 資料值。請參閱時間型分頁。
`until` 時間戳記	指向以時間為基礎的資料範圍結尾的 Unix 時間戳記或 `strtotime` 資料值。請參閱時間型分頁。

回應

JSON 格式物件，包含您所要求的資料。

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

回應內容

屬性	值
`data`	IG 用戶的 IG 影音素材陣列。
`paging`	包含分頁游標和下一頁／上一頁資料集擷取網址的物件。

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

更新

不支援執行此作業。

刪除

不支援執行此作業。