解决PHP连接Google表格API时遇到的404权限错误

Google Sheets API连接中的权限问题

在使用php google api客户端尝试连接google表格时，开发者可能会遇到“404 you need permission”的错误提示，即使已确认文件权限和json凭据设置无误。这种权限错误通常发生在尝试通过api访问用户已授权的google表格资源时，表明应用程序未能获得执行特定操作所需的正确权限。

核心原因：API作用域（Scope）不正确

此问题的根本原因在于所使用的API作用域（Scope）不正确或已过时。在提供的代码示例中，https://spreadsheets.google.com/feeds 这个作用域是针对旧版Google Spreadsheets API（GData API）的，而非当前推荐使用的Google Sheets API v4。当客户端尝试使用旧版作用域访问新版API时，便会引发权限不足或资源未找到的错误。

Google API要求应用程序声明其需要访问用户数据的哪些部分以及执行何种操作。这些声明通过作用域来实现。如果声明的作用域与实际操作不匹配，或者使用了不再受支持的作用域，就会导致权限问题。

正确的Google Sheets API作用域

为了成功与Google Sheets API交互，必须使用以下授权作用域之一，具体取决于应用程序所需的操作权限：

• https://www.googleapis.com/auth/drive：允许查看、编辑、创建和删除用户Google云端硬盘中的所有文件。这是一个广义的权限，通常不推荐，除非应用程序确实需要对所有文件进行广泛访问。
• https://www.googleapis.com/auth/drive.file：允许查看和管理应用程序已打开或创建的Google云端硬盘文件和文件夹。这是一个更受限制且推荐的作用域，适用于仅需管理特定文件的场景。
• https://www.googleapis.com/auth/drive.readonly：允许查看和下载用户Google云端硬盘中的所有文件。
• https://www.googleapis.com/auth/spreadsheets：允许查看、编辑、创建和删除用户Google云端硬盘中的所有Google表格文件。这是最常用于全面管理Google表格的权限。
• https://www.googleapis.com/auth/spreadsheets.readonly：仅允许查看用户Google表格文件。

根据应用程序需要对Google表格执行的操作（例如，读取、写入、创建或删除），应选择最合适且权限最小的作用域。对于需要编辑和管理表格的常见场景，https://www.googleapis.com/auth/spreadsheets 是一个合适的选择。

立即学习“PHP免费学习笔记（深入）”；

代码示例与修正

以下是原始代码中addScope部分的修正示例：

飞书多维表格

表格形态的AI工作流搭建工具，支持批量化的AI创作与分析任务，接入DeepSeek R1满血版

26

查看详情

原始代码（导致错误）：

$this->client = new Google_Client();
$this->client->setApplicationName('BreezingForms Google Drive Spreadsheets');
$this->client->addScope(array('https://spreadsheets.google.com/feeds')); // 错误的作用域
// ... 其他代码

修正后的代码：

$this->client = new Google_Client();
$this->client->setApplicationName('BreezingForms Google Drive Spreadsheets');
// 修正为现代Google Sheets API的作用域
// 如果需要读写权限，推荐使用：
$this->client->addScope(array('https://www.googleapis.com/auth/spreadsheets'));
// 如果只需要读取权限，可以使用：
// $this->client->addScope(array('https://www.googleapis.com/auth/spreadsheets.readonly'));
// ... 其他代码

通过将addScope中的作用域从https://spreadsheets.google.com/feeds更改为https://www.googleapis.com/auth/spreadsheets，应用程序将能够正确地向Google API声明其意图，从而获得访问Google表格所需的权限。

注意事项

1. 刷新或删除现有访问令牌： 在修改API作用域后，至关重要的一步是删除或刷新所有存储的访问令牌（access token）和刷新令牌（refresh token）。这是因为旧的令牌是基于旧的作用域生成的。即使代码中更新了作用域，如果客户端继续使用基于旧作用域的令牌，API请求仍然会失败。 在PHP应用程序中，这通常意味着需要：

   • 清除存储在数据库（如#__breezingforms_addons_gdata表中的password字段，它存储了JSON格式的accessToken）或文件系统（如token.json）中的旧令牌。
   • 强制用户重新进行OAuth认证流程，以获取基于新作用域的全新令牌。 在提供的代码中，可以通过触发gdata_reset逻辑或直接删除数据库中的password字段值来实现。

2. Google Cloud Project设置： 确保您的Google Cloud Project中已启用“Google Sheets API”服务。即使作用域正确，如果API本身未启用，请求也会失败。

3. 客户端ID和密钥： 验证setClientId和setClientSecret中使用的客户端ID和密钥是正确的，并且与您在Google Developers Console中为Web应用程序或服务帐户（取决于您的认证方式）创建的凭据相匹配。

4. 错误处理： 在实际应用中，应实现健壮的错误处理机制，捕获Google_Service_Exception或其他异常，以便更好地诊断和响应API错误。

总结

当PHP应用程序连接Google Sheets API遇到“404 You need permission”错误时，首先应检查并修正所使用的API作用域。将过时的https://spreadsheets.google.com/feeds替换为现代的https://www.googleapis.com/auth/spreadsheets或更具体的读写作用域是解决问题的关键。同时，务必在更改作用域后清除并重新获取访问令牌，以确保权限更新生效。通过遵循这些步骤，开发者可以有效地解决Google Sheets API的权限问题，确保应用程序顺畅地与Google表格进行数据交互。

参考资料

• Sheets API Authorize Requests

以上就是解决PHP连接Google表格API时遇到的404权限错误的详细内容，更多请关注php中文网其它相关文章！