媒體

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 /{media-id}

取得圖像、影片或相簿的欄位和關係連線。

必備條件

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

要求語法

GET https://graph.instagram.com/{media-id}
  ?fields={fields}
  &access_token={access-token}

查詢字串參數

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

索引鍵	值
`access_token` 必要字串	應用程式用戶的 Instagram 用戶存取權杖。
`fields` 逗號分隔清單	您想傳回的欄位和關係連線逗號分隔清單。如果省略這項，會傳回預設欄位。

欄位

您可用 fields 查詢字串參數要求媒體的下列欄位。

欄位名稱	說明
`caption`	媒體的說明文字。無法為相簿內的媒體傳回。注意：在說明文字中使用表情符號時，編碼格式應為 UTF-8，字元長度可能會依所使用的表情符號而受到影響。
`id`	媒體編號。
`is_shared_to_feed`	僅限 Reels。當設定為 `true` 時，代表連續短片可同時顯示在動態消息和 Reels 頁籤中。當設定為 `false` 時，代表連續短片只能顯示在 Reels 頁籤中。無論該值為何，都不會決定連續短片是否實際顯示在 Reels 頁籤中，因為該連續短片可能不符合資格需求或未被演算法所選擇。請參閱連續短片規格，瞭解資格條件。
`media_type`	媒體類型。可以是 `IMAGE`、`VIDEO` 或 `CAROUSEL_ALBUM`。
`media_url`	媒體網址。
`permalink`	媒體的永久網址。如果媒體包含著作權保護的影音素材，或者已標示為違反著作權，系統將忽略該欄位。
`thumbnail_url`	媒體的縮圖圖像網址。僅適用於 `VIDEO` 媒體。
`timestamp`	媒體的發佈日期（ISO 8601 格式）。
`username`	媒體擁有者的用戶名稱。

關係連線

可要求下列關係連線作為路徑參數或使用 fields 查詢字串參數。

關係連線	說明
`children`	取得媒體相簿的媒體清單。僅適用於 `CAROUSEL_ALBUM` 媒體。

回應

JSON 格式物件，包含預設和要求的欄位和關係連線。

{
  "{field}":"{value}",
  ...
}

cURL 範例

要求

curl -X GET \
  'https://graph.instagram.com/17895695668004550?fields=id,media_type,media_url,username,timestamp&access_token=IGQVJ...'

回應

{
  "id": "17895695668004550",
  "media_type": "IMAGE",
  "media_url": "https://fb-s-b-a.akamaihd.net/...",
  "username": "jayposiris"
  "timestamp": "2017-08-31T18:10:00+0000"
}

更新

不支援執行此作業。

刪除

不支援執行此作業。