Instagram 平台

Instagram 平台的變更記錄

此變更記錄涵蓋有關 Instagram API 的變更情況。

相關變更記錄

2024 年 10 月 3 日

歡迎訊息流程現適用於含有 Instagram 登入功能的 Instagram API。瞭解詳情。

2024 年 10 月 2 日

Media Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The video media metric video_views will no longer be supported.

The following endpoints and metrics are affected:

User Insights

Applies to v21.0+. Will apply to all versions on January 8, 2025.

The email_contacts, get_direction_clicks, profile_views, text_message_clicks, website_clicks, and phone_call_clicks time series metrics will no longer be supported.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • email_contacts
    • get_direction_clicks
    • profile_views
    • text_message_clicks
    • website_clicks
    • phone_call_clicks

2024 年 9 月 17 日

新的 scope 值

適用於所有版本。

為確保 scope 值與權限名稱之間保持一致，我們為 Instagram 登入 Instagram API 引入了新的 scope 值。新的 scope 值為：

  • instagram_business_basic
  • instagram_business_content_publish
  • instagram_business_manage_comments
  • instagram_business_manage_messages

這些值會分別取代現有的 business_basic、business_content_publish、business_manage_comments 和 business_manage_messages 值。

請注意，舊的 scope 值將於 2025 年 1 月 27 日停用。在此日期之前更新程式碼非常重要，可避免應用程式功能受到任何影響。如不更新程式碼，您的應用程式將無法呼叫 Instagram 端點。

更正：停用日期由 2024 年 12 月 17 日改為 2025 年 1 月 27 日。

2024 年 7 月 23 日

推出含有 Instagram 登入功能的全新 Instagram API

此全新 Instagram API 的內容：

  • 不再需要您提供 Facebook 專頁
  • API 呼叫的代管網址為 graph.instagram.com
  • 此 API 的新權限：
    • instagram_business_basic
    • instagram_business_content_publish
    • instagram_business_manage_comments
    • instagram_business_manage_messages
  • Messenger API 將不再用於傳送 Instagram 訊息
  • 新應用程式在建立 Meta 應用程式時將會加入全新的 Instagram 產品
  • 現有應用程式可在應用程式管理中心中加入全新的 Instagram 產品

瀏覽我們的轉移指南，了解此含有 Instagram 登入功能的全新 Instagram API 是否適合您。

2024 年 6 月 11 日

Instagram 留言 Webhooks

適用於所有版本。

當用戶回應獲加強推廣的 Instagram 帖子或 Instagram 廣告帖子時，在 comments 欄位的 value 物件中，其 media 物件除了會傳回 ad_id 和 ad_title 外，也會傳回 original_media_id。詳情請參閱設定 Instagram 專用 Webhooks。

2024 年 5 月 21 日

Instagram User Insights

Applies to v20.0+. Will apply to all versions on August 19, 2024.

The last_14_days, last_30_days, last_90_days and prev_month timeframes will no longer be supported for the reached_audience_demographics and engaged_audience_demographics metrics.

The following endpoints and metrics are affected:

2023 年 9 月 12 日

Deprecation of Media and User Insights

Applies to v18.0+. Will apply to all versions on December 11, 2023.

Duplicative and legacy Instagram insight metrics are being deprecated. Please see documentation for the endpoints and Instagram Insights for more information on which metrics to use in their place.

The following endpoints and metrics are affected:

  • GET /{ig-user-id}/insights
    • AUDIENCE_GENDER_AGE
    • AUDIENCE_LOCALE
    • AUDIENCE_COUNTRY
    • AUDIENCE_CITY
  • GET /{ig-media-id}/insights
    • CAROUSEL_ALBUM_IMPRESSIONS
    • CAROUSEL_ALBUM_REACH
    • CAROUSEL_ALBUM_ENGAGEMENT
    • CAROUSEL_ALBUM_SAVED
    • CAROUSEL_ALBUM_VIDEO_VIEWS
    • TAPS_FORWARD
    • TAPS_BACK
    • EXITS
    • ENGAGEMENT

Note: total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.total_interactions, which is listed as an alternative for some of the deprecated metrics, is currently only available using version 18.0 and does not work with older versions. When querying older versions before Dec 11, 2023, please use the engagement metric.

2022 年 11 月 9 日

Instagram Webhooks

適用於所有版本。

當用戶回應獲加強推廣的 Instagram 帖子或 Instagram 廣告帖子時，在 comments 欄位的 value 物件中，其 media 物件會傳回 ad_id 和 ad_title。

10 月 31 日

Reels—商品標籤

適用於所有版本。

Reels 版本的 Instagram 商品標註 API 現已推出。發佈連續短片時，您最多可標註 30 件商品。

2022 年 6 月 28 日

連續短片

適用於所有版本。

現支援連續短片。如要將影片發佈為連續短片，請在建立單一媒體帖子容器時，將 media_type 參數設定為 REELS。請參閱 POST /ig-user/media endpoint 參考資料，了解哪些參數可用於連續短片，以及連續短片類影片的相關要求。

2022 年 6 月 27 日

舊版 Instagram API 文件

適用於所有版本。

舊版 Instagram API 開發人員文件已被移除，現將重新導向 Instagram 開放平台開發人員文件。

2022 年 6 月 20 日

商品標註功能

適用於所有版本。

您現可在 Instagram 企業的已發佈媒體上建立和管理 Instagram 購物商品標籤。請參閱商品標註功能指南以了解如何操作。

2022 年 5 月 27 日

商品款式

適用於所有版本。

合作夥伴如正在使用商品標註測試版的，現在搜尋商品目錄時，系統會傳回符合查詢搜尋條件的所有商品款式。

2022 年 3 月 15 日

輪播帖子

適用於所有版本。

您現在可以使用 Instagram API 發佈包含多張圖片和多段影片的帖子（輪播帖子）。請參閱內容發佈指南，了解完整的發佈步驟。

如果您的應用程式已獲准使用發佈內容所需的權限，則無需再次通過應用程式審查即可使用此功能。

2021 年 11 月 9 日

直播視像

適用於所有版本。

您現在可以使用 Instagram API，獲取應用程式用戶正在直播的直播視像 Instagram 媒體、獲取這些影片的留言；並可使用 Instagram 訊息功能 API，向留言作者傳送私人回覆（direct 訊息）。為支援此功能，我們已作出以下變更：

  • 新的 GET /ig-user/live_media 關係連線可以傳回提出要求時您應用程式用戶正在直播的直播視像 Instagram 媒體
  • Instagram 留言的 media 欄位現會傳回一個物件，其中包含留言所在的媒體之編號 (id) 及其發佈位置 (media_product_type)
  • 新的 live_comments Instagram Webhooks 欄位可以傳送通知，其中包含在您應用程式用戶的直播視像正在直播時的即時留言

請參考 Instagram 訊息功能 API 私人回覆文件，了解如何向對您應用程式用戶的直播視像 Instagram 媒體留言的用戶傳送私人回覆。

2021 年 10 月 20 日

Instagram 留言

適用於所有版本。

兩個新欄位已加進 Instagram 留言：

  • from — 傳回包含留言建立者的 IGSID (id) 和用戶名稱 (username) 的物件。
  • parent_id — 如果此留言在另一則 Instagram 留言上建立（即另一則留言的回覆），則這個代碼傳回其上層 Instagram 留言的編號。

Instagram Webhooks

適用於所有版本。

comments Instagram Webhooks 欄位現已在 value 欄位物件包含以下屬性：

  • from.id — 建立留言的 Instagram 用戶之 IGSID。
  • from.username — 建立留言的 Instagram 用戶之用戶名稱
  • media.id — Instagram 留言所在的 Instagram 媒體之編號。
  • media.media_product_type — 留言所在的 Instagram 媒體介面（發佈地點）。
  • parent_id — 如果此留言在另一則 Instagram 留言上建立（即另一則留言的回覆），則這個代碼為其上層 Instagram 留言的編號。

2021 年 10 月 5 日

以下變更適用於 2021 年 10 月 5 日或之後建立的 Instagram TV 影片。在此日期之前建立的 Instagram TV 影片不受這些變更的影響。

於 2022 年 1 月 3 日，上述變更將適用於所有 API 版本和所有 Instagram TV 影片，不論影片於何時建立亦然。這意味著從 2022 年 1 月 3 日開始，使用舊 API 版本的應用程式將能夠查詢 Instagram TV 影片（讀取支援功能在 10.0 版本中推出，僅限於 10.0 及以上版本）。

從 14.0 版本起，系統將不再支援 video_title 欄位；如果要求此欄位，API 將傳回錯誤。

2021 年 6 月 8 日

讚好數目

適用於 v11.0 及更新版本。將從 2021 年 9 月 7 日起適用於所有版本。

如果透過另一個端點或欄位擴充間接查詢 Instagram 媒體，系統會在媒體擁有者隱藏讚好數目時於 API 回應中略去 like_count 欄位。若是直接查詢 Instagram 媒體（只能由 Instagram 媒體擁有者提出），即使媒體的讚好數目已經隱藏，系統仍會傳回實際的讚好數目。


時間型分頁

適用於 v11.0 及更新版本。

已向 GET /{ig-user-id}/media 端點加入 since 和 until 參數，以支援基於時間的分頁。

2021 年 5 月 26 日

如果應用程式用戶並非擁有媒體，而且媒體擁有者已隱藏讚好數目，那麼當透過其他端點間接查詢 Instagram 媒體時，系統現在會於 like_count 欄位傳回 0。若是直接查詢 Instagram 媒體（只能由 Instagram 媒體擁有者提出），即使擁有者隱藏了媒體的讚好數目，系統仍會傳回實際的讚好數目。

2021 年 5 月 4 日

就著如何計算 Instagram 用戶的 online_followers 衡量數據作出小型變更。

2021 年 4 月 14 日

日本用戶執行的限時動態 Instagram 媒體互動將不再包含在一些 replies 衡量數據計算中：

  • 對於日本用戶所製作的限時動態，replies 衡量數據目前將傳回值 0。
  • 對於由日本以外用戶所製作的限時動態，replies 衡量數據將傳回回覆次數，但由日本用戶所作出的回覆將不會包含在計算中。

2021 年 4 月 12 日

已修復限時動態 Instagram 媒體接觸人數衡量數據的小錯誤。

2021 年 4 月 9 日

  • 如果 IG 容器的 error_code 欄位值為 ERROR，容器上的 status 欄位現在會傳回錯誤子代碼。
  • IG 媒體分析資料video_views 衡量數據現在支援相簿，並會傳回相簿中所有影片 video_views 的總和，而不是 0。

2021 年 3 月 16 日

v10.0 版或以上版本現已支援 IGTV 媒體。這適用於所有端點，但用於內容發佈和 Webhooks 的端點除外。為支援此變更，新的 media_product_type 和 video_title 欄位已加入至 Instagram 媒體節點。IGTV 媒體必須在發佈時已分享至 Instagram （已啟用「發佈預覽內容」或「將預覽分享到動態消息」），才能經 API 存取。

2021 年 1 月 26 日

內容發佈測試已結束，所有開發人員現在可以使用 Instagram 專業帳戶發佈媒體。請參閱內容發佈指南，了解使用詳情。

2020 年 12 月 2 日

根據歐盟的《電子通訊私隱指令》，在 2020 年 12 月 1 日以後，由歐洲經濟區用戶所執行與訊息傳送相關的限時動態 Instagram 媒體互動將不再計入某些衡量數據：

  • 對於由歐洲經濟區用戶建立的限時動態，replies 衡量數據現將傳回 0 數值。
  • 對於歐洲經濟區以外地區用戶所建立的限時動態，replies 衡量數據雖然會傳回其回覆次數，但來自歐洲經濟區用戶的回覆將不會納入計算範圍。

此變更適用於所有版本。

2020 年 11 月 10 日

  • Instagram 用戶洞察報告—follower_count 值現在會更及時地與 Instagram 應用程式中顯示的相應值同步。此外，follower_count 現在最多傳回 30 天而非 2 年的數據。此變更適用於 v9.0 版及以上版本，且自 2021 年 5 月 9 日起適用於所有版本。

2020 年 5 月 5 日

2019 年 12 月 3 日

  • 洞察報告—為同步 API 與 Instagram 應用程式的行為，有關 Instagram 用戶的洞察報告現在僅適用於擁有至少 100 位追蹤者的 Instagram 用戶。

2019 年 8 月 13 日

  • 商家探索—商家探索 API 現在可用於獲取關於其他 Instagram 創作者帳戶的數據。

2019 年 5 月 22 日

2019 年 5 月 9 日

  • Webhooks—story_insights 欄位現在需要使用 instagram_manage_insights 權限而非 instagram_manage_comments。

2018 年 10 月 31 日

  • 主題標籤搜尋 API—您現在可以使用我們全新的主題標籤搜尋 API ，搜尋使用特定主題標籤標註的媒體。#spooky！

2018 年 10 月 23 日

  • /{ig-media-id}/comments 關係連線—使用 v3.1 版 API 或以下版本發出的 GET 要求將以時間順序傳回結果。使用 v3.2 版及以上版本提出的要求將按時間倒序傳回結果。

2018 年 6 月 7 日

  • /{ig-media-id} 節點—您現在可以使用欄位擴充獲取媒體物件的 permalink 欄位。

2018 年 5 月 1 日

  • 商家驗證—如要使用 Instagram Graph API，所有應用程式都必須接受商家驗證，這是應用程式審查程序的一部分，而現在所有 Instagram Graph API 端點都必須接受此驗證。在 2018 年 5 月 1 日前曾接受審查的應用程式必須在 2018 年 8 月 1 日前再次接受審查，否則將會失去存取此 API 的權限。

2018 年 4 月 24 日

  • /{ig-comment-id} 節點：
    • 加入了新的 username 欄位。
    • 如果是 GET 要求，除非提出要求的用戶擁有相關回應，否則回應中不會包含 user 欄位。相反，我們會傳回所有留言者的 username。這也適用於透過其他 API（如提及 API）所作出的留言查詢。
  • /{ig-media-id} 節點：
    • 加入了新的 username 欄位。
    • 如果是 GET 要求，除非提出要求的用戶擁有相關媒體物件，否則回應中不會包含 owner 欄位。相反，我們會傳回所有留言者的 username。這也適用於透過其他 API（如提及 API）所作出的媒體物件查詢。

2018 年 4 月 23 日

  • 洞察報告 API—洞察報告現在將包含透過 API、Facebook 廣告介面和 Instagram 推廣功能產生的廣告動態。這會影響下列衡量數據：

    • impressions
    • reach

2018 年 3 月 13 日

  • 內容發佈 API—參與測試的合作夥伴現可在發佈相片時使用 /{ig-user-id}/media 關係連線，來標註地點和公開的 Instagram 用戶。

2018 年 3 月 8 日

  • 公開欄位—/{ig-media-id} 節點的 timestamp 欄位現在屬於公開欄位，可以透過欄位擴充傳回。

2018 年 2 月 22 日

  • 公開欄位—使用欄位擴充透過關係連線存取時，/{ig-user-id}、/{ig-comment-id} 和 /{ig-media-id} 節點現在將傳回所有公開欄位。請參閱每個節點的參考文件，了解哪些欄位為公開欄位。

2018 年 2 月 8 日

  • 內容發佈 API—參與測試的合作夥伴現可在發佈相片時透過 /{ig-user-id}/media 關係連線加入主題標籤。#crazywildebeest 好極了！