媒體

代表圖像、影片或相簿。

建立

不支援執行此作業。

讀取

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`	媒體的說明文字。無法為相簿內的媒體傳回。
`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"
}

更新

不支援執行此作業。

刪除

不支援執行此作業。