名称层次结构
Google Ads API 中使用的资源名称是分层的，反映了 Google Ads 中实体的组织结构。几乎所有资源都是 Customer 资源的子资源，这意味着几乎每个 API 调用都必须以特定的 Google Ads 帐号为目标。例如，广告系列、广告组、广告和关键字都是根客户资源的子资源。
| 资源 | 资源名称 |
|---|---|
| 客户 | customers/1234567890
|
| 广告系列 | customers/1234567890/campaigns/8765432109
|
| AdGroup | customers/1234567890/adGroups/54321098765
|
| AdGroupAd | customers/1234567890/adGroupAds/54321098765~2109876543210
|
资源 ID
在整个 API 中，Google Ads 实体（客户、广告系列等）均通过其资源名称来引用。但请务必注意，资源名称本身可能具有唯一的数字资源 ID，用于标识层次结构中的每个对象。在这些情况下，解析资源名称以提取这些资源 ID 并组合新资源 ID 可能会很有用。
例如，检查上表中的 AdGroupAd 资源名称：
customers/1234567890/adGroupAds/54321098765~2109876543210
这可以细分为各个资源 ID（以集合 ID 分隔），如下所示：
| 资源名称的组成部分 | |||||||
|---|---|---|---|---|---|---|---|
| 资源 ID |
|
||||||
| 集合 ID |
|
||||||
通过解析各个 ID，您可以派生新的资源名称，以引用广告组广告的客户 (customers/1234567890) 或其广告组 (customers/1234567890/adGroupAds/54321098765)。
共享对象的标识符
API 中的大多数对象都与特定的 Google Ads 客户相关联。但是，有些对象类型可以在多个帐号之间共享。实际上，这是指否定关键字列表或跨帐号转化操作，通常由经理创建，然后与多个客户帐号共享。
此类对象的资源名称将有所不同，具体取决于您要将 API 调用发送到哪个帐号。
示例：跨帐号转化操作
假设我们的经理帐号 987-654-3210 与其其中一个客户帐号 123-456-7890 共享跨帐号转化操作：
例如，通过对经理帐号进行 API 调用来更新转化操作的回溯期，系统会使用资源名称 customers/9876543210/conversionActions/257733534 引用共享对象。
如果对客户帐号发出 API 调用以选择使用共享的转化操作，系统将使用资源名称 customers/1234567890/conversionActions/257733534 来引用它。
这也是相同的底层转化操作，但其资源名称是相对于访问它时所用的账号而言的。