REST API への移行
Marketo Engage SOAP API は、2026年3月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 操作のみをサポートしていました。