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