在哪里可以获取适用于Node.js的官方Google Ads API？

你在官方入门文档页没找到Node.js相关内容是因为官方将各语言客户端的实操指引做了单独归类，直接按以下步骤实现即可，不需要从零手写原生请求逻辑：

• 前置凭证准备
  提前完成Google Cloud项目权限关联、Google Ads账户授权，拿到4个必填参数：
  • Google Ads开发者Token
  • OAuth2 客户端ID、客户端密钥
  • OAuth2 刷新Token
  • 待操作的Google Ads账户ID（注意要去掉ID里的连接横杠，使用纯数字格式）
• 安装官方Node.js客户端依赖
  在你的Node.js项目根目录执行安装命令：
  npm install google-ads-api
  该依赖为Google官方维护的客户端封装，内置了请求签名、版本兼容、错误处理逻辑，不需要手动拼接HTTP请求。
• 客户端初始化代码
  在项目中新建配置模块，初始化客户端实例：

  const { GoogleAdsApi } = require('google-ads-api');
  
  // 初始化全局客户端
  const adsClient = new GoogleAdsApi({
    client_id: '你的OAuth2客户端ID',
    client_secret: '你的OAuth2客户端密钥',
    developer_token: '你的Google Ads开发者Token',
  });
  
  // 绑定要操作的具体广告账户
  const targetCustomer = adsClient.Customer({
    customer_id: '目标广告账户纯数字ID',
    refresh_token: '你的OAuth2刷新Token',
    login_customer_id: '如果你用经理账号授权，这里填经理账号纯数字ID，普通账号可省略该字段'
  });
  

• 测试请求示例（拉取广告系列数据）
  初始化完成后可以直接调用封装方法拉取数据，不需要手动构造GAQL查询语句的请求结构：

  async function fetchCampaignList() {
    try {
      const campaignList = await targetCustomer.report({
        entity: 'campaign',
        attributes: ['campaign.id', 'campaign.name', 'campaign.status'],
        metrics: ['metrics.impressions', 'metrics.clicks', 'metrics.cost_micros'],
        date_constant: 'LAST_30_DAYS'
      });
      console.log('拉取到的广告系列数据:', campaignList);
      return campaignList;
    } catch (err) {
      console.error('API请求报错:', err);
    }
  }
  
  fetchCampaignList();
  

• 常见注意事项
  • 刚申请的开发者Token默认为测试权限，仅能操作申请时绑定的测试广告账户，操作正式账户需要先提交Google Ads的API权限审核
  • 接口返回的金额类字段单位为微单位，1000000 微单位对应当地货币的1个标准单位，统计金额时需要做除法换算
  • 客户端库会自动适配最新的稳定版API，不需要手动在请求里指定API版本号，避免版本不兼容报错
  • 如果出现权限类报错，优先检查刷新Token对应的账号是否有目标广告账户的操作权限，以及开发者Token是否和当前使用的Google Ads账户属于同一个管理体系

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