名称层次结构
Search Ads 360 Reporting API 中使用的资源名称是分层的，反映了 Search Ads 360 中实体的组织方式。几乎所有资源都是 Customer 资源的子资源，这反映了一个事实，即几乎每个 API 调用都必须针对特定的 Search Ads 360 帐号。例如，广告系列、广告组、广告和关键字都是根客户资源的子资源。
| 资源 | 资源名称 |
|---|---|
| 客户 | customers/1234567890
|
| 广告系列 | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
资源 ID
Search Ads 360 Reporting API 实体（客户、广告系列等）在整个 API 中均通过其资源名称进行引用。但请务必注意，资源名称本身可能具有唯一的数字资源 ID，用于标识层次结构中的每个对象。在这些情况下，通过解析资源名称来提取这些资源 ID 并组建新 ID 可能很有用。
例如，检查上表中的 AdGroupAd 资源名称：
customers/1234567890/adGroupAds/54321098765~2109876543210
资源 ID 可以拆分为各个资源 ID（由集合 ID 分隔），如下所示：
| 资源名称组成部分 | |||||||
|---|---|---|---|---|---|---|---|
| 资源 ID |
|
||||||
| 集合 ID |
|
||||||
通过解析单个 ID，您可以派生新的资源名称来引用广告组广告的客户 (customers/1234567890) 或其广告组 (customers/1234567890/adGroupAds/54321098765)。