Search Ads 360 Reporting API 以现代化平台为基础,并引入了许多新概念。以下部分将对此进行介绍。
资源
资源对象取代了报告类型。现在,您可以使用一种类似于 SQL 的新查询语言来查询所有资源,而无需请求预定义的报告类型。如需了解详情,请参阅 Search Ads 360 Reporting API 结构。
搜索报告
在新版 API 中,搜索有自己的服务。搜索服务取代了旧版报告服务。所有查询都会通过 SearchAds360Service,该对象提供两种方法(SearchStream 和 Search),用于搜索和检索报告数据及指标。这两种搜索方法都会返回与搜索查询匹配的所有 SearchAds360Row 对象。如需了解详情,请参阅创建搜索报告。
资源元数据
借助 SearchAds360FieldService,您可以动态请求 SearchAds360Service 搜索方法中提供的资源、资源字段、细分键和指标的目录。如需了解详情,请参阅检索资源元数据。
字段名称
该 API 引入了以点表示法分隔的嵌套字段名称。例如,campaign.id 和 ad_group.id。您还可以进一步嵌套,例如 ad_group.campaign.id。如需了解详情,请参阅 Search Ads 360 Reporting API 结构。
旧版 Search Ads 360 API 中的报告基于不同实体上用于表示类似概念的单独字段。例如,campaign 和 adgroup 报告都包含单独的 campaignId 字段。
查询语言
该 API 引入了 Search Ads 360 查询语言。这是一种灵活的类 SQL 语言,可用于定义查询,以检索最适合您业务的特定报告数据。如需了解详情,请参阅 Search Ads 360 查询语言。
Get 请求
在新版 API 中,搜索有自己的服务 (SearchAds360Service),但 GET 请求仍然存在于每个实体的特定服务上。例如,您可以从 CustomColumnService 中获取自定义列信息。
如需了解详情,请参阅 Search Ads 360 Reporting API 中的格式更改。
自定义列
在新版 Search Ads 360 中,公式列和自定义转化被称为自定义列。
详细了解自定义列。
新的 CustomColumnService 可启用自定义列。只要您拥有必要的权限,就可以请求账号树中任何账号拥有的 CustomColumn 资源。
账号管理
新版 Search Ads 360 会将账号划分为经理账号、子级经理账号和客户账号的层次结构。经理账号代表旧版 Search Ads 360 中的代理机构账号,子级经理账号代表旧版 Search Ads 360 中的广告客户账号。如需了解详情,请参阅 Search Ads 360 经理账号简介。
您可以查询账号树,然后针对您想要获取报告数据的每个账号提交请求。
由于账号层次结构发生了变化,与广告客户/代理机构概念相关的字段已替换为适当的替代方案,以便尽可能提供对等的功能。如需查看受影响的字段及其替代字段的列表,请参阅字段映射。
登录客户 ID 标头
login-customer-id 是一个新标头,当使用经理账号访问子级经理账号或客户账号时,必须使用此标头。如需了解详情,请参阅登录客户 ID 标头。
版本控制
Search Ads 360 Reporting API 使用语义化版本控制。版本分为主要版本和次要版本,格式为 vMAJOR_MINOR。如需了解详情,请参阅版本控制。