MsAdsSoap · ウェイトリスト

1/31 までに Microsoft Advertising SOAP API から移行——どの SDK に上げるか、どの REST 経路に移すか、何を再テストするかを把握

  1. 新しい API 機能・機能強化は REST のみ。既存の SOAP 連携は引き続き動作。

  2. SOAP API の完全廃止(full deprecation)。

時間が足りない場合:複雑な連携は Microsoft Advertising サポートまたはアカウントチームに延長移行プランを相談できます。

日付は Microsoft Learn「Migrate to REST API」と Microsoft Advertising 公式ブログ(2026年4月1日)に基づく。Microsoft は API アクセスへの影響を避けるため 2026年10月1日までの移行を推奨。

10月1日から新しい API 機能は REST のみ——既存の SOAP 連携は、2027年1月31日に SOAP が完全廃止されるまで動作し続けます。4 つの質問に答えるだけ——SOAP 直接呼び出しか旧 SDK か(言語は?)、REST 限定の新機能が必要か、REST や msads を試したか、連携の複雑さは。タイムラインリスク、SDK アップグレードまたは REST 対応手順、回帰チェックリストを取得。developer token、OAuth トークン、client secret、アカウント ID、コードを貼る必要はありません。

独立したツール。Microsoft とは提携・承認関係にありません · 市場検証ページ · 無料ウェイトリスト · Microsoft Advertising に接続しません

課題

2 つの日付:10/1 · 1/31

Microsoft Learn と Microsoft Advertising 公式ブログによると、API はレガシー SOAP から REST へ 2 段階で移行します。2026年10月1日から新しい API 機能・機能強化はすべて REST のみで提供され、既存の SOAP 連携は移行期間中も即時の影響なく動作します。2027年1月31日に SOAP API は完全廃止されます。Microsoft は API アクセスへの影響を避けるため 2026年10月1日までの移行を推奨しており、2 つの日付の間は多くの広告主の Q4 繁忙期と重なります。公式ガイダンスは充実していますが、migrate、Python、PHP ガイドと API リファレンスに分散しています。

Before

  • migrate ページ、Python/PHP ガイド、API リファレンスを行き来
  • 2 つの日付を混同して慌てる、または時間があると思い繁忙期を越えてしまう
  • 2027年2月に入札・レポートのジョブ失敗に気づく

After——MsAdsSoap なら

  • 4 問で自分の言語とサービスに関係する経路と変更点だけ
  • 10/1=新機能 REST のみ、1/31=SOAP 完全廃止を明確に区別し、繁忙期も表示
  • sandbox 回帰リスト+サービス別検証+ロールバック手段で 1/31 前に切り替え

公式タイムライン(Microsoft Learn+Microsoft Advertising 公式ブログ)

日付ステータス変更内容
2024年提供開始REST API が登場(公式ブログ)。
2026年4月1日発表公式ブログ「Evolving the Microsoft Advertising API platform」で REST への移行を発表。既存の SOAP 連携に即時の影響はなし。
2026年10月1日新機能は REST のみ新しい Microsoft Advertising API 機能・機能強化はすべて REST API のみで提供。既存の SOAP 連携は移行期間中も引き続き動作。
2027年1月31日SOAP 完全廃止SOAP API の完全廃止(full deprecation)予定日——最終期限。

Microsoft は API アクセスへの影響を避けるため 2026年10月1日までの移行を推奨。時間が必要な大規模・複雑な連携は、Microsoft Advertising サポートまたはアカウントチームに延長移行プランを相談できます(延長期間は非公開)。リリースノートは大規模な開発を繁忙期以外に完了するよう推奨——10/1〜1/31 は多くの広告主の年末繁忙期と重なります。

ソリューション

MsAdsSoap ができること

SOAP/旧 SDK のままの広告自動化チーム向け、Microsoft Advertising SOAP → REST 移行準備の意思決定レイヤー:連携方式 × 言語 × 新機能の要否 × 進捗 × 複雑さ → タイムラインリスク+経路+対応表+回帰チェックリスト。Microsoft Learn の代替でも API コネクタでもなく、Microsoft とは提携関係にありません。

WHO

Microsoft Advertising のレガシー SOAP API(SOAP 直接の HTTP 呼び出し、または旧 Bing Ads SDK:.NET/Java 13.0.22 未満、Python bingads パッケージ、PHP microsoft/bingads)で入札・レポート・アカウント自動化を動かしているアドテクエンジニア、代理店エンジニア、社内のグロース/マーケティング/データエンジニア。REST/新しい msads SDK への移行がまだ終わっていないチーム。

PROBLEM

2026年10月1日から新しい API 機能・機能強化はすべて REST のみ(既存の SOAP 連携は移行期間中も動作し、即時の影響なし)。2027年1月31日に SOAP API は完全廃止。経路は言語で分かれます——.NET/Java は SDK を最新版へ、Python/PHP は新しい msads パッケージへ(import/namespace、enum、例外、認証ヘッダーがすべて変わる)、SDK なしは REST URL+JSON へ。ドキュメントは migrate、Python、PHP ガイドと API リファレンスに分散しています。

SOLUTION

4 問に答えるだけで、個別のタイムラインリスク、SDK アップグレード経路または REST 対応手順、SOAP → REST コード変更対応表、回帰チェックリストを出力。developer token、OAuth トークン、client secret、アカウント/カスタマー ID、ソースコードは一切求めません。Microsoft Advertising コネクタではありません。

RESULT

10/1 があなたにとって単なる「新機能ゲート」か、ロードマップの妨げになるのかが分かり、1/31 までにどの SDK に上げるか・どの REST 呼び出しを変えるかが分かり、Q4 繁忙期前に sandbox 回帰を完了。2027年2月になって入札やレポートのジョブ失敗に気づくことはありません。

言語別の SDK/REST 経路(Microsoft Learn による)

現在の構成公式の経路
.NET/Java、Bing Ads SDK 13.0.22 未満最新 SDK へアップグレード(2026年8月4日のリリースノートでは 13.0.29)し、利用中のサービスを 1 つずつ検証。
Python、任意バージョンの bingads パッケージmsads(pip install msads)へ切り替え+下の変更対応表のコード変更。
PHP、Composer microsoft/bingadsComposer microsoft/msads へ切り替え+namespace とクラスの変更。
SDK なし(SOAP 直接呼び出し)REST API の URL+JSON リクエストへ移行(API リファレンスの各メソッドに REST URL と例あり)。Microsoft は SDK の採用を推奨。

.NET/Java で 13.0.22 以上?13.0.22 は主に Customer Management/Billing を REST に移したリリースのため、最新 SDK に上げて利用中の全サービスを検証するのが安全です。Microsoft Learn には .NET/Java のコードレベル移行ガイドがないため、細部を創作しません。

機能

機能

製品仮説に基づくマーケティング上のポイントです。需要検証用であり、正式な仕様の約束ではありません。

タイムラインリスク

新機能が必要?10/1 から REST のみ。不要なら最終期限は 2027年1月31日。連携が複雑なら延長移行プランを検討。各日付までの残り日数も表示。

言語別の SDK/REST 経路

.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・トークン更新を検証してから、ロールバック手段付きで本番を切り替え。

SOAP → REST 変更対応表(公式ガイドに記載の項目のみ)

項目SOAP/旧 SDKREST/msads
認証ヘッダー(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/フラグ enum元の大文字小文字;スペース区切り文字列すべて大文字;ビット演算 |
Python 例外WebFaultApiException(openapi_client.exceptions)
PHP 実行環境ext-soapPHP ^7.4 || ^8.0、ext-soap 不要、guzzle を使用
PHP namespaceMicrosoft\BingAds\Microsoft\MsAds\Rest\
PHP クライアントServiceClientCampaignManagementServiceApi などの *ServiceApi クラス(async メソッドあり)
PHP アカウント情報ヘッダーAccountId/CustomerId は AuthorizationData で設定;トークン更新後に 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 ホスト(本番)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 が含まれないため、ダウンロード/アップロード処理は自前で実装します。

ウェイトリストに登録

仕組み

仕組み

3 ステップ。Microsoft Advertising への接続もトークンも不要です。

  1. 1

    4 つの質問に答える

    SOAP 直接か旧 SDK か、言語は?10/1 以降の新機能が必要?REST や msads は試した?連携の複雑さは?

  2. 2

    タイムラインリスクと移行経路を確認

    10/1 の新機能ゲートと 1/31 の最終期限を個別に評価し、あなたの言語向けの SDK アップグレードまたは REST 対応手順を表示。すべて Microsoft Learn へのリンク付き。

  3. 3

    変更・再テスト・切り替え

    SOAP → REST 変更対応表、サービス棚卸し、sandbox 回帰チェックリスト——トークン・シークレット・アカウント ID・コード不要。

ユースケース

こんなチーム向け

当てはまる状況があれば、検証にご協力いただくためにウェイトリストへご登録ください。

自社入札エンジン(Python bingads)

1 時間ごとに入札を変更。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 ヘッダー、JSON リクエストが必要。公式 SDK に切り替えるかも検討。

10/1 以降の新機能を使いたいプロダクトチーム

新機能は REST のみ。既存の SOAP 部分が動き続けていても、関連サービスを先に移行する必要があります。

大規模アドテク基盤

サービスもアカウントも多数。サポート/アカウントチームに延長移行プランを申請すべきか、申請前に用意する棚卸しリストを判断。

よくある質問

よくある質問

MsAdsSoap は Microsoft 公式ツールですか?

いいえ。独立したツールで、Microsoft とは提携・承認関係にありません。情報はすべて Microsoft 公式ドキュメントをリンク付きで引用しています。

10月1日に SOAP 連携はどうなりますか?

公式ドキュメントによれば、既存の SOAP 連携は移行期間中も動作します。10/1 から新機能・機能強化は REST のみで提供されます。SOAP は 2027年1月31日に完全廃止されます。なお Microsoft は影響を避けるため 10/1 までの移行を推奨しています。

Microsoft Learn との違いは?

公式は言語ごと・ページごとにすべてのケースを説明しています。私たちはあなたの連携方式・言語・サービス・進捗に絞り、タイムラインリスク・経路・対応表・回帰チェックリストを出します。

Microsoft Advertising サポート、アカウントチーム、コンサルタントとの違いは?

サポートとアカウントチームはあなたのアカウントと延長申請に対応し、コンサルタントは移行プロジェクト全体を担います。MsAdsSoap は軽量で静的なセルフサービスツールで、検証期間中のウェイトリストは無料です。

.NET/Java SDK 13.0.22 以上なら何もしなくてよい?

公式の指示は「13.0.22 未満なら最新版へアップグレード」です(リリースノートの最新は 13.0.29)。13.0.22 は主に Customer Management/Billing を REST に移したリリースのため、最新版に上げて利用中の全サービスを検証するのが安全です。

期限を延長できますか?

Microsoft は、大規模・複雑な連携で時間が必要な場合、Microsoft Advertising サポートまたはアカウントチームに延長移行プランを相談できるとしています。延長期間は公開されていないため、私たちは約束しません。

developer token、OAuth トークン、client secret、アカウント ID、コードを求めますか?

いいえ。求めず、保持せず、保存しません。Microsoft Advertising アカウントにも接続しません。

コードの書き換えや移行作業をしてくれますか?

いいえ。MVP は静的な質問票+経路+対応表+チェックリスト+ウェイトリストです。

Early Access はいつ?

ウェイトリストからメールで順次ご案内。偽の公開日は出しません。

MsAdsSoap は独立したツールであり、Microsoft とは提携・承認関係にありません。

ウェイトリストに登録

ウェイトリスト

ウェイトリストに登録

仕事用メールを登録して、MsAdsSoap の Early Access とローンチ情報を受け取りましょう。メールと任意のチェックボックス/プルダウンのみ——自由記述欄は一切ありません。

利用サービス(複数可) (任意)

ウェイトリスト/Early Access/ローンチ通知のみに使用。developer token、OAuth アクセス/リフレッシュトークン、client secret、アカウント/カスタマー ID、コードは貼らないでください。いつでも解除可能。