如何在Google Ads API广告效果报告中获取LabelIds与Labels数据

方案1：复用现有ad_group_ad查询，补充标签字段 #

• 你现有GAQL无需大改，直接在SELECT部分增加ad_group_ad.labels字段即可，该字段会返回当前扩展文字广告关联的所有标签的resource_name数组，resource_name格式为customers/{客户ID}/labels/{标签ID}，提取最后一段即可得到原AdWords API中的LabelIds。
• 如果需要获取标签名称，你可以提前执行一次全量标签查询拉取账号下所有标签的ID与名称映射，后续匹配即可，全量标签查询GAQL示例：

SELECT
  label.id,
  label.name,
  label.resource_name
FROM label

如果你不需要按标签维度拆分效果数据，优先选择该方案，无需额外处理数据重复问题。

方案2：直接从ad_group_ad_label资源查询，一步获取所有字段 #

• GAQL的单资源查询支持拉取该资源关联的所有上下游资源属性与指标，你直接切换查询的FROM资源为ad_group_ad_label，就可以同时拉到广告属性、效果指标、标签ID、标签名称所有字段，不用额外做匹配。
• 对齐你原有需求的GAQL语句如下：

SELECT
  customer.descriptive_name,
  ad_group.id,
  ad_group.name,
  ad_group.status,
  ad_group_ad.ad.type,
  campaign.id,
  campaign.name,
  campaign.status,
  metrics.clicks,
  metrics.conversions,
  metrics.cost_micros,
  ad_group_ad.ad.final_urls,
  ad_group_ad.ad.expanded_text_ad.description,
  ad_group_ad.ad.expanded_text_ad.description2,
  ad_group_ad.ad.expanded_text_ad.headline_part1,
  ad_group_ad.ad.expanded_text_ad.headline_part2,
  ad_group_ad.ad.expanded_text_ad.headline_part3,
  ad_group_ad.ad.id,
  metrics.impressions,
  ad_group_ad.ad.expanded_text_ad.path1,
  ad_group_ad.ad.expanded_text_ad.path2,
  ad_group_ad.status,
  label.id,
  label.name,
  label.resource_name
FROM ad_group_ad_label
WHERE
  ad_group_ad.status = ENABLED
  AND campaign.status = ENABLED
  AND ad_group.status = ENABLED
  AND ad_group_ad.ad.type = EXPANDED_TEXT_AD
  AND segments.date DURING LAST_30_DAYS

注意事项 #

单条广告如果绑定了多个标签，该查询结果会返回对应多条记录，你可以在拉取到数据后，按ad_group_ad.resource_name（广告的唯一标识）分组，把标签相关字段聚合为列表，即可对齐原AdWords API的返回格式。

内容的提问来源于stack exchange，提问作者Marvin Laskov