资源名称

名称层次结构

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

通过其资源来引用 Google Ads 实体（客户、广告系列等） 名称。但请务必注意 名称本身可能就有唯一的数字资源， 标识 层次结构中的每个对象在这些情况下，将 资源名称来提取这些资源 ID 并组合成新的 ID。

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

customers/1234567890/adGroupAds/54321098765~2109876543210

这可以细分为各个资源 ID（用 集合 ID） 如下所示：

资源名称的组成部分
资源 ID	客户 ID： "1234567890" 广告组 ID： "54321098765" 广告组广告 ID： "2109876543210"
集合 ID	"customers" "adGroupAds"

通过解析各个 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。

这与基础转化操作相同，但其资源名称是相对的 访问该资源时所用的账号