新版 Search Ads Reporting API 中的新概念

Search Ads 360 Reporting API 基于现代化平台,引入了许多新概念。下文将对此进行介绍。

资源

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

搜索报告

在新 API 中,Google 搜索拥有自己的服务。搜索服务取代了旧版报告服务。所有查询都会进行 SearchAds360Service,后者提供了 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。如需了解详情,请参阅版本控制