媒體

代表圖片、影片或相簿。

建立

不支援這項操作。

讀取

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"
}

更新

不支援這項操作。

刪除

不支援這項操作。