Instagram 影音內容

代表 Instagram 相簿、相片或影片（上載的影片、直播視像、Reel 或限時動態）。

我們推出了以下欄位：

• legacy_instagram_media_id

我們並不支援以下推廣 API Instagram 廣告端點欄位：

• filter_name
• location
• location_name
• latitude
• longitude

建立

不支援這項操作。

讀取

GET /<IG_MEDIA_ID>

獲取 Instagram 影音內容的欄位和關係連線。

必要條件

限制

• comments_count 和 like_count 等欄位僅傳回目標 Instagram 影音內容的互動情況，不包含其他介面的資料。例如，comments_count 會傳回相片上的回應次數，但不會傳回內有該相片的廣告之回應次數。使用 total_comments_count 和 total_like_count 獲取彙整數據，其中包括來自推廣／加強推廣／廣告影音素材的互動次數。如果連線階段用戶可以存取多重發佈 Facebook 帖子，則該帖子的計數可能包含在內。
• 除非應用程式用戶亦可在應用程式執行管理員級別任務，否則說明文字不能包含 @ 符號。
• 某些欄位（如 permalink）不適用於相簿中的相片（子物件）。
• 直播視像 Instagram 影音內容僅能在直播時讀取。
• 此 API 僅傳回 Instagram 專業帳戶所擁有影音內容的資料。此 API 不可用於獲取 Instagram 個人帳戶所擁有影音內容的資料。
• reposts_count、saved_count、shares_count、total_like_count、total_comments_count 和 total_views_count 欄位不適用於輪播子影音內容，僅會為頂層影音內容物件傳回。影音內容擁有者可以停用讚好、回應、瀏覽、轉發和分享的顯示設定，此時系統將不會傳回相應欄位。

要求語法

GET https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID> \
  ?fields=<LIST_OF_FIELDS> \
  &access_token=<ACCESS_TOKEN>

路徑參數

查詢字串參數

欄位

可透過欄位擴充功能讀取的公開欄位。

關係連線

可透過欄位擴充功能傳回的公開關係連線。

cURL 範例

範例要求

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

回應範例

{
  "id": "17918920912340654",
  "media_type": "IMAGE",
  "media_url": "https://sconten...",
  "owner": {
    "id": "17841405309211844"
  },
  "timestamp": "2019-09-26T22:36:43+0000"
}

更新

POST /<IG_MEDIA_ID>

啟用或停用 Instagram 影音內容的留言功能。

限制

不支援直播視像 Instagram 影音內容。

要求語法

POST https://<HOST_URL>/<API_VERSION>/<IG_MEDIA_ID>
  ?comment_enabled=<BOOL>
  &access_token=<ACCESS_TOKEN>

路徑參數

查詢字串參數

cURL 範例

範例要求

curl -i -X POST \
 "https://graph.instagram.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

回應範例

{
  "success": true
}

刪除

DELETE /<IG_MEDIA_ID>

刪除 Instagram 影音內容。

必要條件

限制

此 API 僅支援設有 Facebook 登入的 Instagram API。非廣告帖子、限時動態、Reels 和整個輪播相簿均受支援。如要刪除輪播相簿中的影音內容，則必須指定輪播容器影音內容編號，以刪除整個輪播相簿。不支援單獨刪除輪播廣告中的影音內容。

要求語法

POST https://graph.facebook.com/<API_VERSION>/<IG_MEDIA_ID>
  ?access_token=<ACCESS_TOKEN>

路徑參數

查詢字串參數

cURL 範例

範例要求

curl -i -X DELETE \
 "https://graph.facebook.com/v26.0/17918920912340654?comment_enabled=true&access_token=EAAOc..."

回應範例（成功）

{
  "success": true,
  "deleted_id": "17918920912340654"
}

回應範例（失敗，影音內容類型不受支援）

{
  "error": {
   "message": "Fatal",
   "type": "OAuthException",
   "code": -1,
   "error_subcode": 2207073,
   "is_transient": false,
   "error_user_title": "Media Type Not Supported",
   "error_user_msg": "The media type is not supported for this endpoint",
   "fbtrace_id": "Api-OlNdfcpOwIu6hNaT5Kw"
  },
}