Instagram 平台
返回中文(香港)
這份文件已更新。
中文(香港) 的翻譯尚未完成。
英文更新時間：2023年9月27日
中文(香港) 更新時間：2022年7月1日

變更記錄

此變更紀錄涵蓋對 Instagram 圖形 API 所做的變更。

相關變更記錄

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 Webhook

適用於所有版本。

當用戶在 加強推廣的 Instagram 貼文或 Instagram 廣告貼文上留言時，將在 comments欄位的value 物件的 media 物件中傳回 ad_id 和 ad_title。

10 月 31 日

Reels – 商品標籤

適用於所有版本。

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

2022 年 6 月 28 日

Reels

Applies to all versions.

Reels are now supported. To publish a video as a reel, set the media_type parameter to REELS when creating a single media post container. Refer to the POST /ig-user/media endpoint reference to learn which parameters can be used with reels as well as requirements for reels videos.

Note: Beginning November 9, 2023, the VIDEO value for media_type will no longer be supported. Use the REELS media type to publish a video to your feed.

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 日

按讚數

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

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


時間型分頁

適用於 11.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 日

已修復發生在限時動態 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 日

為了符合歐盟的電子通訊隱私指令，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！