加入等候名單

MsAdsSoap · 等候名單

1/31 前搬離 Microsoft Advertising SOAP API——知道該升哪個 SDK 或走哪條 REST 路徑、要重測什麼

  1. 新 API 功能與 enhancement 只在 REST；既有 SOAP 整合仍運作。

  2. SOAP API 完全 deprecated。

需要更多時間？複雜整合可向 Microsoft Advertising support 或 account team 申請延長遷移方案。

日期依 Microsoft Learn《Migrate to REST API》與 Microsoft Advertising 官方 blog（2026-04-01）；官方建議於 2026-10-01 前遷移，以避免 API 存取受影響。

10/01 起新 API 功能只在 REST 推出——既有 SOAP 整合仍會運作，直到 2027-01-31 SOAP 完全 deprecated。回答 4 題——直接呼叫 SOAP 還是舊 SDK（哪個語言）、是否需要只在 REST 的新功能、是否已試過 REST 或 msads、整合有多複雜。取得時程風險、SDK 升級或 REST 對照步驟與回歸清單。從不要求貼 developer token、OAuth token、client secret、帳戶 ID 或程式碼。

加入等候名單 看看 4 題檢查如何運作

獨立工具，與 Microsoft 無隸屬或背書關係 · 市場驗證頁 · 免費等候名單 · 不連 Microsoft Advertising

問題

兩個日期：10/01 · 1/31

依 Microsoft Learn 與 Microsoft Advertising 官方 blog，API 正分兩步從 legacy SOAP 轉向 REST：2026-10-01 起所有新 API 功能與 enhancement 只透過 REST 提供，既有 SOAP 整合在過渡期間繼續運作、無立即影響；2027-01-31 SOAP API 完全 deprecated。官方建議在 2026-10-01 前遷移以避免 API 存取受影響，而兩個日期之間正好跨越多數廣告主的 Q4 旺季。官方文件完整，但分散在 migrate、Python、PHP 指南與 API reference。

Before

  • 在 migrate、Python、PHP 指南與 API reference 間來回對照
  • 搞混兩個日期而恐慌，或以為時間很多而拖過旺季
  • 2027-02 才發現出價與報表排程失敗

After——用 MsAdsSoap

  • 回答 4 題 → 只看到跟你語言與服務有關的路徑與變更
  • 清楚區分：10/01＝新功能 REST-only；1/31＝SOAP 完全 deprecated；標出旺季
  • sandbox 回歸清單＋逐服務驗證＋回退開關，1/31 前切換

官方時程（Microsoft Learn＋Microsoft Advertising 官方 blog）

日期狀態變更內容
2024已推出REST API 推出（官方 blog）。
2026-04-01已宣布官方 blog《Evolving the Microsoft Advertising API platform》宣布轉向 REST；既有 SOAP 整合無立即影響。
2026-10-01新功能只在 REST所有新 Microsoft Advertising API 功能與 enhancement 只透過 REST 提供；既有 SOAP 整合在過渡期間繼續運作。
2027-01-31SOAP 完全 deprecatedSOAP API 排定 full deprecation——硬死線。

官方建議在 2026-10-01 前遷移，以避免 API 存取受影響。需要更多時間（大型或複雜整合）可聯絡 Microsoft Advertising support 或 account team 申請 extended migration plan（官方未公開延長長度）。官方 release notes 建議在旺季外完成大型開發——10/01～1/31 恰好跨越多數廣告主的年末旺季。

解決方案

MsAdsSoap 做什麼

給仍在 SOAP／舊 SDK 上的廣告自動化團隊的 Microsoft Advertising SOAP → REST 就緒決策層：你的整合方式 × 語言 × 新功能需求 × 進度 × 複雜度 → 時程風險＋路徑＋對照＋回歸清單。不是 Microsoft Learn 替代品，也不是 API 連線器；與 Microsoft 無隸屬關係。

WHO

仍透過 Microsoft Advertising API 的 legacy SOAP（直接 SOAP HTTP 呼叫，或舊版 BingAds SDK：.NET／Java 低於 13.0.22、Python bingads 套件、PHP microsoft/bingads）執行出價、報表、帳戶自動化的廣告科技工程師、代理商工程師、企業內部 growth／行銷工程與資料工程；尚未完成 REST／新 SDK（msads）遷移。

PROBLEM

2026-10-01 起所有新 API 功能與 enhancement 只在 REST 提供（既有 SOAP 整合在過渡期仍會運作、無立即影響）；2027-01-31 SOAP API 完全 deprecated。遷移路徑依語言不同：.NET／Java 升級 SDK 到最新版、Python／PHP 換成新的 msads 套件（import／namespace、enum、例外、驗證 header 都變）、無 SDK 者改打 REST URL＋JSON；文件分散在 migrate、Python、PHP 指南與 API reference。

SOLUTION

勾選 4 題 → 產出個人化時程風險、SDK 升級路徑或 REST 對照步驟、SOAP → REST 程式碼變更對照、回歸 checklist。從不要求 developer token、OAuth token、client secret、account／customer ID 或原始碼；不是 Microsoft Advertising 連線器。

RESULT

知道 10/01 對你只是「新功能閘門」還是真的會卡住 roadmap、知道 1/31 前該升哪個 SDK 或改哪些 REST 呼叫、在 Q4 旺季前完成 sandbox 回歸。不必等到 2027-02 才發現出價與報表排程失敗。

依語言給路徑（依 Microsoft Learn）

你的現況官方路徑
.NET／Java，BingAds SDK 低於 13.0.22升級到最新 SDK（2026-08-04 release notes 為 13.0.29），逐一確認你用到的服務。
Python，任何版本 bingads改用 msads（pip install msads）＋程式碼變更（見下方變更對照）。
PHP，microsoft/bingads改用 Composer microsoft/msads＋namespace 與類別變更。
無 SDK（直接 SOAP）改用 REST URL＋JSON request（API reference 每個方法有 REST URL 與範例）；或改採 SDK（官方鼓勵）。

已在 .NET／Java 13.0.22 以上？13.0.22 主要把 Customer Management／Billing 改走 REST，建議升到最新並逐一驗證你用到的服務。Microsoft Learn 未提供 .NET／Java 程式碼層遷移指南，我們不自創細節。

功能特色

功能特色

以下為產品假設的行銷要點，用於需求驗證，不代表正式規格承諾。

時程風險

需要新功能？10/01 起只在 REST。否則硬死線是 2027-01-31。整合複雜？評估申請延長方案。各日期剩餘天數。

依語言給路徑

.NET／Java 低於 13.0.22 → 升到最新 SDK；Python bingads → msads；PHP microsoft/bingads → microsoft/msads；無 SDK → REST URL＋JSON。

SOAP → REST 變更對照

AuthenticationToken → Authorization: Bearer、import 與 namespace、enum、陣列、WebFault／SoapFault → ApiException、REST 主機。

服務盤點

Campaign Management、Bulk、Reporting、Customer Management、Customer Billing、Ad Insight：各自的主機、SDK 類別與要驗證的呼叫。

回歸清單

先在 sandbox 測、比對報表與 bulk 輸出、驗證出價變更、錯誤處理、enum 與 token refresh，再帶回退開關切 production。

SOAP → REST 程式碼變更對照（僅列官方指南寫明者）

項目SOAP／舊 SDKREST／msads
驗證 header（無 SDK）AuthenticationToken: {token}Authorization: Bearer {token}
Python 相依套件suds-jurkourllib3／pydantic
Python 資料模型 importbingads.v13openapi_client.models.campaign／customer／bulk／reporting
Python 陣列ArrayOf*、response.CampaignIds['long']list、response.CampaignIds
Python 呼叫位置參數／suds factory；suds_options、set_elements_to_none()_request= 關鍵字參數；直接建立 model（factory 保留為相容層）；移除 suds_options 與 set_elements_to_none()
Python enum／flag enum原大小寫；空白分隔字串全大寫；位元 |
Python 例外WebFaultApiException（openapi_client.exceptions）
PHP 執行環境ext-soapPHP ^7.4 || ^8.0、不再需要 ext-soap、改用 guzzle
PHP namespaceMicrosoft\BingAds\Microsoft\MsAds\Rest\
PHP clientServiceClientCampaignManagementServiceApi 等 *ServiceApi 類別（提供 async 方法）
PHP 帳戶內容headerAccountId／CustomerId 設在 AuthorizationData；token refresh 後呼叫 refreshAuthorizationData()
PHP 風格／例外SoapVar；SoapFault方法 camelCase、getter／setter、enum UPPER_SNAKE、移除 SoapVar；ApiException
主機SOAP 服務端點campaign.api. / bulk.api. / reporting.api. / clientcenter.api. / adinsight.api.bingads.microsoft.com（sandbox：*.api.sandbox.bingads.microsoft.com）

Python msads 的 ServiceClient 與 authorization 仍從 bingads.* import——看到 import bingads 不代表還在舊套件，需看已安裝套件。Python 的 BulkServiceManager／ReportingServiceManager 介面不變。.NET／Java 官方未公開程式碼層對照：升到最新 SDK 並逐服務驗證。

服務盤點——各服務的 REST 主機與 PHP 類別

服務REST 主機（production）PHP msads 類別
Campaign Managementcampaign.api.bingads.microsoft.comCampaignManagementServiceApi
Bulkbulk.api.bingads.microsoft.comBulkServiceApi
Reportingreporting.api.bingads.microsoft.comReportingServiceApi
Customer Managementclientcenter.api.bingads.microsoft.comCustomerManagementServiceApi
Customer Billingclientcenter.api.bingads.microsoft.comCustomerBillingServiceApi
Ad Insightadinsight.api.bingads.microsoft.comAdInsightServiceApi

sandbox：*.api.sandbox.bingads.microsoft.com——先在這裡跑回歸。官方 client libraries 頁註明 PHP SDK 不含 BulkServiceManager／ReportingServiceManager（需自行處理下載／上傳流程）。

加入等候名單

如何運作

如何運作

三個步驟。不連 Microsoft Advertising、不需任何 token。

  1. 1

    回答 4 題

    直接 SOAP 還是舊 SDK——哪個語言？需要 10/01 後推出的新功能？試過 REST 或 msads 了嗎？整合有多複雜？

  2. 2

    看你的時程風險與路徑

    個人化的 10/01 新功能閘門 vs 1/31 硬死線——加上你語言棧的 SDK 升級或 REST 對照步驟，皆附 Microsoft Learn 連結。

  3. 3

    修改、回歸、切換

    SOAP → REST 程式碼變更表、服務盤點、sandbox 回歸清單——從不要求 token、secret、帳戶 ID 或程式碼。

使用情境

適合誰

如果以下情境讓你有共鳴，歡迎加入等候名單協助我們驗證。

自建出價引擎（Python bingads）

每小時改 bid——需要 msads 遷移清單（import、_request=、enum、例外）與 sandbox 出價回歸，並排在旺季前完成。

代理商多客戶報表管線（.NET SDK 13.0.x 舊版）

Reporting＋Bulk 排程——需要確認 SDK 版本是否低於 13.0.22、升到最新版、逐服務驗證報表輸出一致。

PHP 帳戶管理後台

Customer Management＋Billing——需要 namespace 與 *ServiceApi 對照、AuthorizationData 設 AccountId／CustomerId。

無 SDK 的直接 SOAP 整合（Go／Node／Ruby 等）

需要 REST 主機、Authorization: Bearer header、JSON request，並評估是否改用官方 SDK。

產品團隊想用 10/01 後的新功能

需要知道新功能只在 REST，SOAP 部分即使還能跑也要先遷移相關服務。

大型 ad-tech 平台

服務多、帳戶多——需要評估是否向 support／account team 申請 extended migration plan，以及申請前該準備的盤點清單。

公開訊號

Microsoft 官方公開訊號

僅列 Microsoft Learn 官方文件與 Microsoft Advertising 官方 blog——是公開訊號，不是客戶推薦；無引言、背書、logo 或捏造數字。

常見問題

常見問題

MsAdsSoap 是 Microsoft 官方工具嗎？

不是。MsAdsSoap 為獨立工具，與 Microsoft 無隸屬或背書關係；所有資訊引用 Microsoft 官方文件並附連結。

10/01 我的 SOAP 整合會怎樣？

依官方文件，既有 SOAP 整合在過渡期仍運作；10/01 起新功能與 enhancement 只在 REST；SOAP 於 2027-01-31 完全 deprecated。官方仍建議 10/01 前遷移以避免影響。

和 Microsoft Learn 差在哪？

官方分語言、分頁涵蓋所有情況；我們只針對你的整合方式、語言、服務與進度，輸出時程風險、路徑、對照與回歸清單。

和 support／account team、顧問差在哪？

support／account team 處理你的帳戶與延長申請；顧問做完整遷移專案；我們是輕量靜態自助工具，驗證期 waitlist 免費。

我已在 .NET／Java SDK 13.0.22 以上，還要動嗎？

官方指引是低於 13.0.22 者升到最新版（release notes 最新為 13.0.29）。13.0.22 主要把 Customer Management／Billing 改走 REST，建議升到最新並逐一驗證你用到的服務。

可以延長嗎？

官方表示需要更多時間（大型或複雜整合）可聯絡 Microsoft Advertising support 或 account team 申請延長遷移方案；官方未公開延長長度，我們不做承諾。

會要求 developer token、OAuth token、client secret、帳戶 ID 或程式碼嗎？

不會。從不要求、不持有、不儲存；不連你的 Microsoft Advertising 帳戶。

會幫我改程式或跑遷移嗎？

不會。MVP 是靜態問卷＋路徑＋對照＋回歸清單＋waitlist。

搶先體驗何時開始？

等候名單分批以 Email 邀請；不捏造上線日期。

MsAdsSoap 為獨立工具，與 Microsoft 無隸屬或背書關係；Microsoft 與 Bing 為 Microsoft 集團之商標。

加入等候名單

等候名單

加入等候名單

留下工作 Email，取得 MsAdsSoap 搶先體驗與上線通知。表單只有 Email 與選填勾選／下拉選單——沒有任何自由文字欄位。

使用的服務（可複選） （選填）

僅用於等候名單、搶先體驗與上線通知；請勿貼 developer token、OAuth access／refresh token、client secret、account 或 customer ID、程式碼；可隨時退訂。