用戶影音內容

代表用戶的影音內容集合。

建立

不支援這項操作。

讀取

GET /{user-id}/media

取得用戶的影音內容集合。

限制

不支援限時動態。
不支援推廣貼文中的媒體。
傳回最高 10K 最近建立的媒體。

必備條件

類型	條件
存取權杖	Instagram 用戶
權限	`instagram_graph_user_media`、`instagram_graph_user_profile`

要求語法

GET https://graph.instagram.com/{api-version}/{user-id}/media
  ?access_token={access-token}

路徑參數

預留位置	值
`{api-version}` 字串	API 版本。
`{user-id}` 必要字串	應用程式用戶的應用程式範圍用戶編號（11.0 以上版本）或原始用戶編號（所有版本）。

查詢字串參數

加入下列查詢字串參數，以擴充要求。

索引鍵	值
`access_token` 必要字串	應用程式用戶的 Instagram 用戶存取權杖。
`fields` 逗號分隔清單	針對結果集中每個影音內容節點，您希望透過欄位擴充功能傳回的影音內容欄位逗號分隔清單。
`since` 時間戳記	指向以時間為基礎的資料範圍開頭的 Unix 時間戳記或 `strtotime` 資料值。請參閱以時間為基礎的分頁。
`until` 時間戳記	指向以時間為基礎的資料範圍結尾的 Unix 時間戳記或 `strtotime` 資料值。請參閱以時間為基礎的分頁。

回應

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

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

回應內容

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

cURL 範例

要求

curl -X GET \
  'https://graph.instagram.com/v19.0/10218560180051171/media?access_token=IGQVJ...'

回應

{
  "data": [
    {
      "id": "17895695668004550"
    },
    {
      "id": "17899305451014820"
    },
    {
      "id": "17896450804038745"
    },
    {
      "id": "17881042411086627"
    }
  ],
  "paging": {
    "cursors": {
      "after": "MTAxN...",
      "before": "NDMyN..."
      },
    "next": "https://graph.faceb..."
  }
}

更新

不支援這項操作。

刪除

不支援這項操作。