REST API への移行
Marketo Engage SOAP API は、2025年10月31日（PT）以降に廃止される予定です。サービスの中断を回避するために、SOAP API を使用したすべての既存の統合は、この日付までに廃止するか、Marketo Engage REST API に移行する必要があります。
移行
SOAP API は、REST API と比較して、サポートされるユースケースの範囲が制限されます。ユースケースをマッピングするエンドポイントを決定する際は、Marketo 統合ベストプラクティスに従う必要があります
CRM 同期およびデータウェアハウスの書き出しのユースケースでは、参照アーキテクチャが使用できます。
認証
Marketo REST API では、クライアント資格情報付与タイプを使用した OAuth 2.0 ベースの認証を使用します。アクセストークンの有効期間は、作成後 1 時間です。
リード
SOAP API では、リードデータの同期、Munchkin cookie の関連付け、およびリードの結合をサポートしています。アプリケーションが SOAP syncLead メソッドを呼び出して marketoCookie パラメーターを設定する場合は、次のいずれかの方法で移行できます。
- リードを同期 RESTメソッドを使用し、その後に関連付けられたリードを使用
- フォームを送信を呼び出すことができますが、これにはマーケティングアセットの設定と Forms API とのインタラクションが必要です
foreignSysPersonId キータイプを使用するアプリケーションでは、この外部識別子を表すカスタムリードフィールドを使用するように移行し、リードを同期またはリードの一括読み込み REST メソッドのいずれかを使用する必要があります。
M オブジェクト
M オブジェクトは、外部分析用の商談属性データの書き出しをサポートする包括的な概念で、商談、商談ロール、プログラムという 3 つのオブジェクトタイプで機能しました。
REST ドキュメント：
静的リスト
SOAP API での静的リストのユースケースは、メンバーシップとリードデータの取り込み、およびリストに追加、リードを一括読み込み、またはリストから削除の REST メソッドを使用して実行できるメンバーシップの削除に制限されています。
アクティビティ
SOAP API では、アクティビティの取得のみをサポートしています。
REST ドキュメント：
キャンペーン
REST ドキュメント：
SOAP API では、リクエスト可能なスマートキャンペーンを選定するためのリードのトリガー、リクエスト可能なキャンペーンの取得、およびスマートキャンペーンの今後の実行のスケジュールのスマートキャンペーンの 3 つのユースケースのみをサポートしています。
カスタムオブジェクト
REST ドキュメント：
SOAP API では、カスタムオブジェクトの CRUD 操作のみをサポートしていました。