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 – 商品標籤

適用於所有版本。

Instagram 產品標註功能已可供 Reels 使用。發佈連續短片時，最多可以標註 30 項商品。

2022 年 6 月 28 日

Reels

適用於所有版本。

現在可支援連續短片。若要發佈影片做為連續短片，請在建立單一影音素材貼文容器時，將 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 取得應用程式用戶直播中的直播影片 IG 影音素材、取得這些影片的留言，以及使用 Instagram 傳訊 API 傳送私密回覆（direct 訊息）給留言作者。為了支援此功能，系統已進行以下變更：

  • 新的 GET /ig-user/live_media 關係連線可以傳回應用程式用戶要求時直播的直播影片 IG 影音素材
  • IG 留言的 media 欄位現在會回傳，以及同時包含留言發表處所在影音素材的編號（id）和發佈位置（media_product_type）的物件
  • 新的 live_comments Instagram Webhooks 欄位可傳送通知，該通知包含應用程式用戶的直播影片在直播時的直播留言

請參閱 Instagram 傳訊 API 私密回覆文件，瞭解如何傳送私密回覆給已對應用程式用戶的直播影片 IG 影音素材發表留言的用戶。

2021 年 10 月 20 日

IG 留言

適用於所有版本。

IG 留言中已新增兩個新欄位：

  • from - 傳回包含留言建立者之 IGSID（id）和用戶名稱（username）的物件。
  • parent_id - 若此留言建立在另一個 IG 留言上（即回覆另一個留言），則傳回父系 IG 留言的編號。

Instagram Webhooks

適用於所有版本。

comments Instagram Webhooks 欄位現在包含下列 value 欄位物件中的屬性：

  • from.id - 建立留言之 Instagram 用戶的 IGSID。
  • from.username - 建立留言之 Instagram 用戶的用戶名稱
  • media.id - 留言發表處所在 IG 影音素材的編號。
  • media.media_product_type - 留言發表處所在 IG 影音素材的介面（發佈位置）。
  • parent_id - 若此留言建立在另一個 IG 留言上（即回覆另一個留言），則為父系 IG 留言的編號。

2021 年 10 月 5 日

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

  • media_product_type欄位將傳回 FEED，而不是 IGTV
  • 系統將不會傳回 video_title欄位
  • 現已支援 Instagram Webhookscomments 和 mentions 欄位

在 2022 年 1 月 3 日，無論影片的建立日期為何，上述變更將適用於所有 API 版本和所有 Instagram TV 影片。這表示從 2022 年 1 月 3 日開始，使用舊版 API 的應用程式將能夠查詢 Instagram TV 影片（讀取支援於第 10.0 版中推出，並僅限於 10.0 以上版本使用）。

從第 14.0 版開始，系統將不再支援 video_title 欄位，如果要求該欄位，API 將擲回錯誤。

2021 年 6 月 8 日

按讚數

適用於 11.0 以上版本，將於 2021 年 9 月 7 日套用至所有版本。

如果透過另一個端點或欄位擴充功能間接查詢 IG 影音內容，當影音內容擁有者已隱藏按讚數時，系統將會省略 API 回應中的 like_count 欄位。不過，即使已隱藏影音內容的按讚數，直接查詢 IG 影音內容（只能由 IG 影音內容擁有者執行）仍會傳回實際按讚數。


時間型分頁

適用於 11.0 以上版本。

已在 GET /{ig-user-id}/media 端點中新增 since 和 until 參數來支援時間型分頁。

2021 年 5 月 26 日

現在開始，如透過另一個端點間接查詢 IG 影音內容，like_count 欄位遇到下列情況時會傳回 0：若應用程式用戶並未擁有該影音內容，且影音內容擁有者已隱藏按讚數。只有 IG 影音內容擁有者能直接查詢 IG 影音內容，即使擁有者已隱藏影音內容的按讚數，這樣的查詢方式仍會傳回實際按讚數。

2021 年 5 月 4 日

針對 IG 用戶的 online_followers 衡量指標計算方式進行微幅變更。

2021 年 4 月 14 日

日本用戶所進行的限時動態 IG 媒體互動，不再包含於部分 replies 衡量指標計算中：

  • 若是日本用戶所建立的限時動態，replies 衡量指標現在將傳回 0 值。
  • 若是日本以外的用戶所建立的限時動態，replies 衡量指標將傳回回覆次數，但日本用戶所進行的回覆將不會包括在計算中。

2021 年 4 月 12 日

已修復發生在限時動態 IG 媒體上的觸及人數衡量指標小錯誤。

2021 年 4 月 9 日

  • 如果 IG 容器的 error_code 欄位值為 ERROR，容器的 status 欄位現在會傳回錯誤子代碼。
  • IG 媒體洞察報告 video_views 衡量指標現在支援相簿，將傳回相簿中所有影片的 video_views 總和，而不是 0。

2021 年 3 月 16 日

10.0 以上版本現在支援 IGTV 媒體。此適用於所有端點，除了用於內容發佈和 Webhooks 的端點以外。為支援此變更，IG 媒體節點加入了新的 media_product_type 和 video_title 欄位。IGTV 媒體必須於發佈時分享至 Instagram（需啟用張貼預覽或分享預覽至動態），才能透過 API 存取。

2021 年 1 月 26 日

內容發佈測試版已經結束，所有開發人員現在都可以在 Instagram 專業帳號上發佈媒體。如需使用方式的詳細資訊，請參閱內容發佈指南。

2020 年 12 月 2 日

為了符合歐盟的電子通訊隱私指令（ePrivacy Directive）規範，2020 年 12 月 1 日之後，歐洲經濟區（EEA）用戶所進行的訊息相關限時動態 IG 影音內容互動，不再包含於某些衡量指標計算中：

  • 若是 EEA 的用戶建立的限時動態，replies 衡量指標現在會傳回 0 值。
  • 若是 EEA 之外的用戶建立的限時動態，replies 衡量指標將傳回回覆次數，但 EEA 的用戶所進行的回覆將不會包括在其計算中。

此變更適用於所有版本。

2020 年 11 月 10 日

  • IG 用戶洞察報告 - follower_count 值與其在 Instagram 應用程式中顯示的對應值現在能夠更緊密地對應。此外，follower_count 現在將傳回最多 30 天的資料，而非 2 年。此變更適用於 9.0 以上版本，且將於 2021 年 5 月 9 日套用至所有版本。

2020 年 5 月 5 日

2019 年 12 月 3 日

  • 洞察報告 - 為使 API 行為與 Instagram 應用程式的行為對應，IG 用戶的洞察報告現在只適用於有 100 位以上粉絲的 IG 用戶。

2019 年 8 月 13 日

  • Business Discovery - Business Discovery 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 關係連線 - 使用 API 3.1 以下版本發出的 GET 要求會依時間先後順序傳回結果。若使用 3.2 以上版本發出要求，則系統會依時間先後反向排序傳回結果。

2018 年 6 月 7 日

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

2018 年 5 月 1 日

  • 商家驗證 - 若要使用 Instagram 圖形 API，所有應用程式均需經過商家驗證，此為應用程式審查程序的一部分，目前所有 Instagram 圖形 API 端點均需完成此驗證。在 2018 年 5 月 1 日之前審查過的應用程式，必須在 2018 年 8 月 1 日之前再次審查，否則會失去 API 的存取權限。

2018 年 4 月 24 日

  • /{ig-comment-id} 節點：
    • 新增 username 欄位。
    • 針對 GET 要求，除非發出要求的用戶擁有留言，否則回應不會包含 user 欄位；我們會改為所有留言者傳回 username。這也會套用至透過其他 API 建立留言的查詢，例如 Mentions API。
  • /{ig-media-id} 節點：
    • 新增 username 欄位。
    • 針對 GET 要求，除非發出要求的用戶擁有媒體物件，否則回應不會包含 owner 欄位；我們會改為所有留言者傳回 username。這也會套用至透過其他 API 建立媒體物件的查詢，例如 Mentions 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 FTW！