资源名称

名称层次结构

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

资源 ID

在整个 API 中，Google Ads 实体（客户、广告系列等）均通过其资源名称来引用。不过，请务必注意，资源名称本身可能具有唯一的数字资源 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 来引用该转化操作。

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