Google APIs Node.js Client中刷新令牌获取访问令牌的技术问询

我之前在集成GMB API的时候也遇到过这个头疼的问题，官方文档确实有点滞后，不过现在已经摸清楚正确的实现方式了，给你一步步讲清楚：

核心逻辑：OAuth2客户端自动处理令牌刷新 #

Google APIs Node.js Client的OAuth2客户端现在已经内置了令牌自动刷新的机制——只要你初始化时正确传入了刷新令牌，后续调用官方封装的API（比如GMB的接口）时，客户端会自动检测访问令牌是否过期，过期的话会用刷新令牌获取新的访问令牌，同时更新自身的credentials属性，完全不需要你手动处理HTTP请求。

步骤1：初始化OAuth2客户端并设置凭证 #

首先要确保你已经拿到了有效的clientId、clientSecret和refreshToken（这些是通过OAuth2授权流程获取的），然后初始化客户端：

const { google } = require('googleapis');

// 初始化OAuth2客户端
const oauth2Client = new google.auth.OAuth2(
  '你的Client ID',
  '你的Client Secret'
);

// 设置初始凭证，必须包含refresh_token
oauth2Client.setCredentials({
  refresh_token: '你的有效刷新令牌',
  // 如果有已经过期的access_token也可以传，客户端会自动刷新
});

步骤2：调用GMB API时传入OAuth2客户端 #

调用GMB的官方封装API时，把刚才的oauth2Client作为auth参数传入，剩下的刷新逻辑客户端会自动处理：

// 初始化GMB API客户端
const mybusiness = google.mybusiness({
  version: 'v4',
  auth: oauth2Client,
});

// 示例：获取账户下的门店列表
async function getGMBLocations() {
  try {
    const response = await mybusiness.accounts.locations.list({
      parent: 'accounts/你的GMB账户ID',
    });
    
    // 此时如果令牌被自动刷新过，oauth2Client.credentials里已经是新的access_token了
    console.log('当前有效访问令牌:', oauth2Client.credentials.access_token);
    return response.data;
  } catch (error) {
    console.error('调用GMB API出错:', error);
    throw error;
  }
}

// 执行调用
getGMBLocations();

步骤3：手动触发令牌刷新（可选） #

如果你需要在非API调用场景下手动刷新令牌（比如提前更新存储的令牌），可以直接调用客户端的refreshAccessToken()方法，这是官方当前支持的标准方法：

async function manualRefreshToken() {
  try {
    // 调用刷新方法，返回新的凭证
    const { credentials } = await oauth2Client.refreshAccessToken();
    
    // 更新客户端的凭证
    oauth2Client.setCredentials(credentials);
    
    // 这里可以把新的access_token和expiry_date保存到数据库/缓存中
    console.log('手动刷新后的访问令牌:', credentials.access_token);
  } catch (error) {
    console.error('手动刷新令牌失败:', error);
    throw error;
  }
}

// 执行手动刷新
manualRefreshToken();

注意事项 #

• 确保你的刷新令牌是有效的：Google的刷新令牌如果长时间未使用（通常是6个月），会被自动失效，此时需要重新引导用户完成OAuth2授权流程获取新的刷新令牌。
• 不要手动构造刷新令牌的HTTP请求：官方客户端已经封装了所有鉴权逻辑，包括令牌过期检测、刷新请求、凭证更新，手动构造容易出错（比如签名、参数格式问题）。
• 确认GMB API的权限范围：初始化OAuth2授权时，必须请求正确的scope，比如https://www.googleapis.com/auth/business.manage，否则调用GMB API会提示权限不足。

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