Marketo Rest API查询名称含指定字符串的邮件资产异常问题

问题原因 #

Marketo 的 /rest/asset/v1/email/byName.json 接口默认对 name 参数采用后缀匹配逻辑，而非模糊包含匹配，因此仅返回名称以指定字符串结尾的邮件资产。

实现包含查询的具体方法 #

1. 使用SQL风格通配符 % #

Marketo 多数资产查询接口支持通配符匹配，你可以在目标字符串前后添加 % 来实现包含匹配。注意URL中 % 需要转义为 %25，所以实际请求参数应写为：

/rest/asset/v1/email/byName.json?name=%252023%25

这里的 %252023%25 对应转义前的 %2023%，表示匹配名称中任意位置包含2023的资产。

2. 尝试指定 filterType 参数 #

部分 Marketo 资产接口支持通过 filterType 参数明确匹配规则，如果 /rest/asset/v1/email/byName.json 支持该参数，可直接设置为 contains：

/rest/asset/v1/email/byName.json?name=2023&filterType=contains

若接口不支持该参数，优先使用第一种方法。

3. 本地筛选兜底方案 #

如果上述接口层面的方法都无效，只能先调用接口获取全量邮件资产列表，再在本地代码中对资产名称做包含匹配筛选。这种方法效率较低，仅适合数据量较小的场景。

内容的提问来源于stack exchange，提问作者Sunil Jakhar