名称层次结构
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 |
|
通过解析各个 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
。
这与基础转化操作相同,但其资源名称是相对的 访问该资源时所用的账号