用戶媒體

On September 4, 2024, we announced the deprecation of the Instagram Basic Display API.

Starting December 4, 2024, all requests to the Instagram Basic Display API will return an error message. We recommend that you migrate your app to the Instagram API to avoid any disruption to your services.

Visit our News for Developers blog post to learn more.

代表用戶的媒體合集。

建立

不支援這項操作。

讀取

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}` 必要項目字串	應用程式用戶的應用程式範圍用戶編號（v11.0 及以上版本）或原始用戶編號（所有版本）。

查詢字串參數

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

鍵	值
`access_token` 必要項目字串	應用程式用戶的 Instagram 用戶存取憑證。
`fields` 逗號分隔清單	您希望欄位擴充為結果集中每個媒體節點傳回的媒體欄位逗號分隔清單。
`since` 時戳	指向基於時間的數據範圍開頭的 Unix 時戳或 `strtotime` 數據值。請參閱基於時間的分頁。
`until` 時戳	指向基於時間的數據範圍末尾的 Unix 時戳或 `strtotime` 數據值。請參閱基於時間的分頁。

回應

包含您要求獲取的資料之 JSON 格式物件。

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

回應內容

屬性	值
`data`	用戶的媒體陣列。
`paging`	包含分頁游標和下一個／上一個資料集檢索網址的物件。

cURL 範例

要求

curl -X GET \
  'https://graph.instagram.com/v21.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..."
  }
}

更新

不支援這項操作。

刪除

不支援這項操作。