PHP集成Google Drive API：为何仅能检索API上传文件，手动上传文件无法获取

可能的原因 #

1. 权限不匹配
   API调用使用的账号（如服务账号或OAuth授权账号）没有访问手动上传文件的权限：

   • 手动上传文件的账号和API账号不是同一个，且未将文件/文件夹共享给API账号；
   • 若使用服务账号，服务账号未被添加为目标文件夹的协作成员（查看者/编辑者）。

2. API请求参数缺失
   Drive v3 API默认不会返回来自其他驱动器（如共享驱动器）的文件，仅设置supportsAllDrives=true不足以获取所有文件，还需添加includeItemsFromAllDrives=true参数。

3. 关键信息错误

   • API调用的folder_id与手动上传文件所在的文件夹ID不匹配；
   • API使用的access_token对应的账号，与手动上传文件的账号完全无关且无共享权限。

解决步骤 #

1. 验证权限

   • 用API调用对应的账号（如服务账号邮箱、OAuth登录用户）登录Google Drive网页端，确认能看到那些手动上传的文件。如果看不到，立即将目标文件夹或文件共享给该账号，授予至少“查看者”权限；
   • 若使用服务账号，需在Drive网页端将服务账号的邮箱添加为文件夹的协作成员。

2. 修改API请求参数
   在原请求URL中添加includeItemsFromAllDrives=true参数，修改后的请求URL如下：

   https://www.googleapis.com/drive/v3/files?q='FOLDER_ID'+in+parents+and+trashed=false&fields=files(id,name,mimeType)&supportsAllDrives=true&includeItemsFromAllDrives=true
   

   对应的PHP代码中，URL部分修改为：

   $url = "https://www.googleapis.com/drive/v3/files?q='" . $folder_id . "'+in+parents+and+trashed=false&fields=files(id,name,mimeType)&supportsAllDrives=true&includeItemsFromAllDrives=true";
   

3. 核对关键信息

   • 确认folder_id完全正确，可在Drive网页端文件夹的URL中提取；
   • 检查get_google_access_token()返回的token对应的账号，是否与预期一致（可通过调用https://www.googleapis.com/oauth2/v3/userinfo接口验证账号信息）。

4. 排除延迟问题
   若刚手动上传文件，等待1-2分钟后再调用API，避免Drive的索引延迟导致文件未及时出现在响应中。

内容的提问来源于stack exchange，提问作者Jakub Hopciaś