资源名称

名称层次结构

Google Ads API 中使用的资源名称是分层结构的，反映了 Google Ads 中实体的组织结构。几乎所有资源都是Customer 子资源 ，这反映了几乎每个 API 调用都必须以 特定的 Google Ads 账号为目标。例如，广告系列、广告组、广告和关键字都是根客户资源的子资源。

资源 ID

在整个 API 中，Google Ads 实体（客户、广告系列等）都通过其资源名称来引用。不过，请务必注意，资源 名称本身可能具有唯一的数字资源 ID，用于标识 层次结构中的每个对象。在这些情况下，解析资源名称以提取这些资源 ID 并组装新的资源 ID 可能会很有用。

例如，检查上表中的 AdGroupAd 资源名称：

customers/1234567890/adGroupAds/54321098765~2109876543210

您可以将其分解为各个资源 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 引用该转化操作。

这是同一个底层转化操作，但其资源名称相对于用于访问它的账号。