请求格式
在新版 Search Ads 360 Reporting API 中,请求格式取决于您发出的请求类型。在旧版 API 中,您可以使用同步或异步请求请求预定义的报告类型。
搜索
在新 API 中,您可以通过定义符合需求的搜索查询来自定义搜索输出。借助 Search Ads 360 查询语言,您可以搜索所有资源,以查找与一组特定条件匹配的实体列表。所有请求(无论实体类型如何)均针对 SearchAds360Service
发出。如需了解详情,请参阅创建搜索广告报告和 Search Ads 360 查询语言。
响应格式
在新 API 中,响应中填充的字段取决于您使用的服务:
SearchAds360Service
- 对于与搜索参数匹配的每个实体,响应都包含一个
SearchAds360Row
对象。每行包含一个对象(例如广告系列),并且仅包含您在查询中请求的字段。 - 特定服务
- 您一次只能按资源名称请求一个实体。响应包含该实体的所有字段。
客户 ID 格式
在新 API 中,您必须将客户 ID 指定为不带短划线的 10 位数字 (XXXXXXXXXX
)。