如何通过Google Ads API获取广告账户概览中的标记成本数据？

核心问题分析 #

你当前的查询存在两个关键问题：一是资源层级不对（以ad_group为主体只能获取广告组维度数据，而非账户概览）；二是误用了预算提案类字段（这类字段仅对应未生效的预算申请，和实际消耗无关）。

修正方案 #

1. 调整查询的资源层级 #

要获取账户级概览数据，需以customer为核心资源，搭配时间范围参数，确保返回整个账户的汇总消耗。

2. 正确的字段选择与查询语句 #

以下是获取账户实际消耗、预算使用情况的有效查询：

SELECT
  customer.descriptive_name,
  metrics.cost,
  metrics.average_cost,
  SUM(campaign_budget.amount_micros) AS total_campaign_budget_micros,
  account_budget.amount_served_micros
FROM customer
JOIN campaign ON campaign.customer_id = customer.id
JOIN campaign_budget ON campaign_budget.id = campaign.campaign_budget
JOIN account_budget ON account_budget.customer_id = customer.id
WHERE date_range = LAST_7_DAYS
GROUP BY customer.descriptive_name, metrics.cost, metrics.average_cost, account_budget.amount_served_micros

3. 关键字段说明 #

• metrics.cost：指定时间内账户的实际总消耗（微单位，需除以1000000转换为常规货币单位）
• account_budget.amount_served_micros：账户预算已使用的金额（对应后台概览的预算消耗进度）
• SUM(campaign_budget.amount_micros)：所有广告系列的预算总额（账户级总预算）

4. 避坑提示 #

• 不要使用account_budget_proposal相关字段：这类字段对应预算变更提案，仅当提案未生效时存在，和当前实际消耗无关
• 必须指定时间范围：未设置date_range时，API默认返回空或0值
• 权限验证：确保API调用使用的账号拥有目标账户的Standard或GoogleAdsEditor权限，否则可能无法获取完整数据

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