使用jQuery调用Google Sheets API追加行遇403错误求助

问题详情 #

使用jQuery调用Google Sheets API追加行时返回403错误，提示Method doesn't allow unregistered callers (callers without established identity)。目前$.get()能正常读取表格数据，但$.post()写入操作始终失败，已确认表格权限设置为允许写入。

请求URL格式 #

postResURL = `https://sheets.googleapis.com/v4/spreadsheets/${SHEET_ID}/values/Reserved!B2:D7:append?valueInputOption=RAW&key=${API_KEY}`

示例代码 #

const newRow = [[Date.now().toString(), 'xxx@gmail.com', 'some u']];

$.post({ 
    url: postResURL, 
    contentType: 'application/json', 
    data: JSON.stringify(newRow),
}).done(function(response) {
    if (response.updates) {
        console.log('Row added successfully:', response);
    } else {
        console.error('Error adding row:', response);
        alert('Error adding row.');
    }
});

错误响应 #

{
  "error": {
    "code": 403,
    "message": "Method doesn't allow unregistered callers (callers without established identity). Please use API Key or other form of API consumer identity to call this API.",
    "status": "PERMISSION_DENIED"
  }
}

原因分析 #

• API密钥权限限制：Google Sheets API的写入操作（包括追加行）不支持仅用API密钥认证。API密钥仅适用于无需用户身份验证的只读接口，写入操作必须通过OAuth 2.0验证调用者身份。
• 表格权限≠API权限：表格设置为可编辑只是文档层面的权限，API写入操作需要额外的身份认证凭证，API密钥无法提供写入所需的身份校验。

解决办法 #

1. 改用OAuth 2.0认证 #

写入操作必须携带OAuth 2.0生成的访问令牌，在请求头中添加Authorization: Bearer {access_token}：

// 假设已通过Google Sign-In SDK获取到有效accessToken
$.post({ 
    url: postResURL, 
    contentType: 'application/json', 
    data: JSON.stringify(newRow),
    headers: {
        'Authorization': `Bearer ${accessToken}`
    }
}).done(function(response) {
    if (response.updates) {
        console.log('Row added successfully:', response);
    } else {
        console.error('Error adding row:', response);
        alert('Error adding row.');
    }
});

2. 确认API配置 #

• 登录Google Cloud控制台，确保Google Sheets API已启用；
• 完成OAuth同意屏幕配置（测试模式可用于开发阶段）；
• 确保OAuth请求的范围包含https://www.googleapis.com/auth/spreadsheets（全权限读写）或https://www.googleapis.com/auth/spreadsheets.values（仅读写表格值）。

3. 检查请求参数 #

确认追加行的URL格式正确，Reserved!B2:D7:append中的范围需确保目标列与传入数据的列数匹配，避免因范围不匹配导致的权限类错误干扰排查。

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