Google Ads API V11中customers.get的等效接口是什么

Google Ads API 从V10版本开始正式移除了独立的customers.get REST端点，V11版本中获取客户资源的能力统一收敛到搜索服务中，没有保留同路径的替代GET端点。

具体替换方式 #

• 接口路径替换：将原V9版本的GET请求路径/v9/customers/{customer_id}替换为POST请求路径/v11/customers/{customer_id}/googleAds:search
• 请求参数替换：不再通过URL路径传参直接获取资源，而是在POST请求体中传入GAQL查询语句，从customer资源表拉取需要的字段
• 响应结构映射：接口返回结果中results[0].customer对象，和原V9customers.get返回的Customer资源结构、字段语义、枚举值完全兼容，兼容层直接提取该字段返回即可，上层业务的字段解析逻辑无需调整。

请求示例 #

请求头要求和V9版本完全一致，仍需携带developer-token、对应权限的OAuth2凭据，使用经理账号访问时需携带login-customer-id请求头。

请求体示例：

{
  "query": "SELECT customer.descriptive_name, customer.currency_code, customer.time_zone, customer.auto_tagging_enabled, customer.manager, customer.test_account FROM customer LIMIT 1"
}

如果需要完全对齐原V9customers.get的返回字段，只需要把你业务中用到的所有customer开头的字段补全到SELECT子句即可，不需要查询无意义的冗余字段，减少配额消耗和接口延迟。

迁移注意事项 #

• V11版本customers资源分组下仅保留了listAccessibleCustomers（查询当前鉴权可访问的所有客户）、mutate（更新客户配置）类操作端点，不存在其他可以直接获取单个客户详情的GET类端点，通过Search接口拉取customer表数据是官方指定的唯一迁移路径。
• 该适配逻辑从V10版本开始生效，后续升级更高版本时不需要再调整这部分逻辑，所有资源的单条查询都统一通过GoogleAdsService的Search/SearchStream接口实现。

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