gapi.auth2弃用后，OAuth2认证创建表格遇Missing credential错误

问题根源 #

你用的google.accounts.id是Google One Tap身份认证工具，它返回的是ID Token（仅用于验证用户身份，确认用户是谁），但调用Sheets API需要的是OAuth2 Access Token（用于授权访问用户的资源）。

之前的gapi.auth2是完整的OAuth2授权流程，能直接获取带指定scope的Access Token；而你现在用One Tap的ID Token传给gapi.client.setToken()，完全不符合要求——gapi.client.setToken()需要的是包含access_token字段的对象，不是纯ID Token字符串，自然会报凭证缺失错误。

正确解决方案：使用google.accounts.oauth2库 #

要替代弃用的gapi.auth2，应该用专门的OAuth2授权库google.accounts.oauth2，它能正确获取Access Token并支持指定API权限scope。

完整代码示例 #

<!-- 先加载Google OAuth2和gapi客户端库 -->
<script src="https://accounts.google.com/gsi/client"></script>
<script src="https://apis.google.com/js/api.js"></script>

<script>
// 初始化OAuth2客户端
function initOAuth2() {
  google.accounts.oauth2.initTokenClient({
    client_id: '你的CLIENT_ID',
    scope: 'https://www.googleapis.com/auth/spreadsheets',
    callback: handleTokenResponse // 授权成功后的回调
  });
}

// 触发授权流程（可绑定到按钮点击事件）
function requestAuthorization() {
  const tokenClient = google.accounts.oauth2.getTokenClient();
  tokenClient.requestAccessToken({prompt: ''}); // prompt为空表示静默授权，需重新获取同意时设为'consent'
}

// 处理授权返回的Token
function handleTokenResponse(response) {
  if (response.error !== undefined) {
    throw response;
  }
  // 将Access Token设置给gapi.client（必须是包含access_token字段的对象）
  gapi.client.setToken({access_token: response.access_token});
  console.log('授权成功，已获取Access Token');
  // 提前加载Sheets API，避免调用时延迟
  gapi.client.load('sheets', 'v4').then(() => {
    console.log('Sheets API加载完成');
  });
}

// 创建表格函数
function createSpreadsheet() {
  gapi.client.sheets.spreadsheets
    .create({
      properties: {
        title: "My New Spreadsheet",
      },
    })
    .then((response) => {
      console.log("Spreadsheet created:", response.result.spreadsheetUrl);
    })
    .catch((err) => {
      console.error("Failed to create spreadsheet", err);
    });
}

// 页面加载完成后初始化
document.addEventListener('DOMContentLoaded', () => {
  initOAuth2();
  // 示例：给按钮绑定授权事件
  // document.getElementById('authBtn').addEventListener('click', requestAuthorization);
});
</script>

关键说明 #

• google.accounts.oauth2.initTokenClient()：专门用于获取OAuth2访问令牌，必须指定需要的API权限scope（这里是操作表格的权限）
• requestAccessToken()：触发授权弹窗，用户同意后返回包含access_token的响应
• gapi.client.setToken()：必须传入包含access_token字段的对象，不能直接传ID Token字符串，这样gapi.client才能正确携带凭证调用API
• 确保已在Google Cloud项目中启用Sheets API，且OAuth同意屏幕配置中添加了https://www.googleapis.com/auth/spreadsheets权限

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