新版 Search Ads Reporting API 中的新概念

Search Ads 360 Reporting API 以现代化平台为基础,并引入了许多新概念。以下部分介绍了这些方法。

资源

资源对象取代了报告类型。您现在可以使用类似于 SQL 的新查询语言查询所有资源,而不是请求预定义的报告类型。如需了解详情,请参阅 Search Ads 360 Reporting API 结构

搜索报告

在新 API 中,搜索功能有自己的服务。“搜索”服务将取代旧版“报告”服务。所有查询都通过 SearchAds360Service 进行,该 API 提供了 SearchStreamSearch 两种方法,用于搜索和检索报告数据和指标。这两种搜索方法都会返回与您的搜索查询匹配的所有 SearchAds360Row 对象。如需了解详情,请参阅创建搜索报告

资源元数据

借助 SearchAds360FieldService,您可以动态请求以下内容的目录:资源、资源字段、细分键和指标,它们均位于 SearchAds360Service 搜索方法中。如需了解详情,请参阅检索资源元数据

字段名称

该 API 引入了以英文句点分隔的嵌套字段名称。例如,campaign.idad_group.id。您还可以进一步嵌套,例如 ad_group.campaign.id。如需了解详情,请参阅 Search Ads 360 Reporting API 结构

旧版 Search Ads 360 API 中的报告是基于不同实体中针对类似概念的单独字段生成的。例如,campaignadgroup 报告都包含单独的 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。如需了解详情,请参阅版本控制