IG 影音內容

代表 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 專業帳號擁有的影音內容的資料，無法用於取得個人 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。支援非廣告貼文、限時動態、Reel 和整個輪播相簿。若要刪除輪播相簿中的影音內容，您必須指定輪播容器影音內容編號，才能刪除整個輪播相簿。不支援刪除輪播廣告中的個別影音素材。

要求語法

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