媒體

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`，則表示連續短片可同時顯示在動態消息和連續短片分頁。如果為 `false`，則表示連續短片只可顯示在連續短片分頁。請注意，這兩個值都不表示連續短片是否實際顯示在連續短片分頁，因為連續短片可能不符合資格要求或未被我們的演算法選中。有關資格條件的資訊，請參閱連續短片規格。
`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"
}

更新

不支援這項操作。

刪除

不支援這項操作。