Google Drive API PHP调用异常：返回空对象或文件未找到求助

1. 先处理'alt' => 'media'参数的问题 #

'alt' => 'media'是用来下载文件二进制内容的参数，完全不适合用来获取文件元数据。当你调用files->get时带这个参数：

• 如果目标是文件夹，直接会触发异常（文件夹没有可下载的媒体内容）；
• 如果是普通文件，返回的是文件内容而非元数据，自然拿不到parents字段，表现为空对象。

解决：

• 只要是获取文件/文件夹的元数据（比如parents、名称、权限等），必须移除'alt' => 'media'参数；
• 仅在需要下载文件内容时，才使用这个参数，且只对非文件夹类型的文件生效。

2. 检查DriveFile实例的使用逻辑 #

你提到新增空的DriveFile实例后出现问题，要确认这个实例的使用场景：

• 如果是移动文件/文件夹，正确的写法是创建仅包含目标parents的实例，而非空对象：

  $fileMetadata = new DriveFile();
  $fileMetadata->setParents([$newFolderId]);
  // 然后调用更新接口
  $driveService->files->update($fileId, $fileMetadata, ['addParents' => $newFolderId, 'removeParents' => $oldParentId]);
  

• 若你传入空的DriveFile对象去执行更新操作，可能会清空文件的元数据，导致后续请求无法正确识别文件，引发"未找到"异常。

3. 验证服务账号的访问权限 #

即使fileId和folderId正确，服务账号必须拥有目标资源的访问权限：

• 把目标文件/文件夹共享给服务账号的邮箱（格式通常是[服务账号ID]@[项目ID].iam.gserviceaccount.com）；
• 共享权限至少设为"编辑者"（移动操作需要编辑权限），仅"查看者"权限无法执行移动或修改元数据的操作。

4. 调试技巧 #

• 先不指定fields参数，获取完整元数据，确认文件状态和权限：

  $file = $driveService->files->get($fileId);
  print_r($file);
  

• 开启客户端调试模式，查看实际请求和返回的错误详情：

  $client->setDebug(true);
  

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