迁移到REST API

Marketo Engage SOAP API将于2026年1月31日后停用。 应在此日期之前停用所有使用SOAP API的现有集成，或将其迁移到Marketo Engage REST API，以避免服务中断。

迁移

与REST API相比，SOAP API支持的用例范围有限。在确定要映射用例的端点时，您应遵循Marketo集成最佳实践

参考体系结构可用于CRM同步和Data Warehouse导出用例。

身份验证

身份验证文档

Marketo REST API使用基于OAuth 2.0的身份验证以及客户端凭据授权类型。 访问令牌在创建后一小时内有效。

潜在客户

潜在客户API文档

SOAP API支持潜在客户数据同步、Munchkin Cookie关联以及潜在客户合并。 如果您的应用程序调用SOAP syncLead方法并设置marketoCookie参数，则可以通过以下任一方式进行迁移：

使用foreignSysPersonId键类型的应用程序应使用自定义潜在客户字段来表示此外部标识符，并使用同步潜在客户或批量潜在客户导入 REST方法。

M对象

M Objects是一个通用概念，用于支持导出Opportunity Attribution数据以进行外部分析，它使用三种对象类型：Opportunity 、 Opportunity Roles和Programs。

REST文档：

静态列表

SOAP API中的静态列表用例仅限于摄取成员资格和潜在客户数据，以及可以通过添加到列表、批量导入潜在客户或从列表 REST方法删除成员资格来删除成员资格。

活动

SOAP API仅支持检索活动。

REST文档：

营销活动

REST文档：

SOAP API仅支持智能营销活动的三个用例：触发潜在客户以符合可请求的Smart Campaign、检索这些可请求的营销活动和计划将来运行Smart Campaign。

自定义对象

REST文档：

SOAP API仅支持对自定义对象执行CRUD操作。