行銷 API 版本停用項目近期將進行變更以啟用版本自動升級

為了透過讓 API 更具無縫性和高效率來強化其整體體驗，我們很高興地宣佈近期將推出 MAPI 版本自動升級功能。從 2024 年 5 月開始，我們將為不受版本影響的行銷 API 端點啟用自動版本升級功能。這表示在要停用的版本和下一個可用版本之間，如果端點不受影響，平台會自動將呼叫升級到下一個可用版本，而不是直接讓要求失敗。

對 API 進行版本控制是處理 API 變更的常用方法，最常見的是用於發佈突發變更。系統推出新版本之後，將停用舊版本。在 API 停用期間，如果應用程式呼叫已停用的 API 版本，將會收到錯誤：「（#2635）您正在呼叫已停用的廣告 API 版本。請更新到最新版本：vXXX。」

2024 年 5 月 14 日，系統將停用 17.0 版。根據 18.0 版的變更紀錄，以下端點將受到影響：

• POST /act_{ad-account-id}/reachfrequencypredictions
• GET /act_{ad-account-id}/reachestimate
• GET /act_{ad-account-id}/delivery_estimate
• POST /act_{ad-account-id}/adsets
• POST /{adset-id}
• POST /act_{ad-account-id}/saved_audiences
• POST /{saved-audience-id}
• POST /act_{ad-account-id}/credit_cards

如果您的應用程式在 2024 年 5 月 14 日 17.0 版停用後，使用它呼叫 POST /{adset-id}，此 API 要求將失敗，因為自動升級不適用於受下一個可用版本（18.0 版）影響的端點。

如果您的應用程式在 17.0 版停用後，使用它呼叫 GET /{ad-account-id}/insights，平台會將您的呼叫升級到下一個可用版本（18.0 版）。

如果您的應用程式已使用 17.0 後續版本進行呼叫，在版本停用日期將不會發生任何變更。

若要選擇不使用版本自動升級，請前往行銷 API 應用程式產品小卡片下的「設定 > 廣告 API 版本設定」來停用此功能。

若要確認呼叫是否已自動升級，請查看 API 回應標頭瞭解詳情。

• 通知標頭範例：「X-Ad-Api-Version-Warning：因為 16.0 版已停用，系統已將呼叫自動升級到 17.0 版」

如需深入瞭解該行為，請參閱行銷 API 版本控制。

若要查看每個版本中受影響的端點，請參閱變更紀錄。

受影響的端點

• 所有 MAPI 端點

開發人員文件連結

• https://developers.facebook.com/docs/marketing-api/versions#version_auto_upgrade

功能説明文章連結

• https://developers.facebook.com/docs/marketing-apis