资源名称

名称层次结构

Search Ads 360 Reporting API 中使用的资源名称是分层的,反映了 Search Ads 360 中实体的组织方式。几乎所有资源都属于子资源 的 Customer 这表明了几乎所有 API 调用都必须针对 特定 Search Ads 360 账号。例如,广告系列、广告组、广告和关键字 都是根客户资源的子资源。

资源 资源名称
客户 customers/1234567890
广告系列 customers/1234567890/campaigns/8765432109
AdGroup customers/1234567890/adGroups/54321098765
AdGroupAd customers/1234567890/adGroupAds/54321098765~2109876543210

资源 ID

Search Ads 360 Reporting API 实体(客户、广告系列等)是通过其资源进行引用的 名称。但请务必注意 名称本身可能就有唯一的数字资源, 标识 层次结构中的每个对象在这些情况下,将 资源名称来提取这些资源 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).