PHP调用Google Drive Sheets API创建文件并转移所有权遇权限问题

核心问题梳理 #

• 服务账号是独立的Google身份实体，和你的个人Gmail账号完全分离，不能修改credentials.json里的client_email为自己的邮箱，这会直接导致身份验证失败。
• 普通个人Gmail账号无法通过API接收服务账号创建文件的所有权（所有权转移仅支持Google Workspace域内账号），这是触发403错误的关键原因之一；另外API权限范围不足也会导致该报错。

分步解决方案 #

1. 确认并配置正确的API权限范围 #

初始化Google Client时，必须添加足够的Drive API权限范围，测试阶段可使用全权限范围，生产环境按需缩窄：

$client = new Google\Client();
$client->setApplicationName('Drive API PHP Service');
$client->setScopes([Google\Service\Drive::DRIVE]);
$client->setAuthConfig('credentials.json');
$client->setAccessType('offline');

2. 先给个人Gmail添加文件访问权限（替代直接转移所有权） #

因为个人Gmail无法接收服务账号文件的所有权，先给你的账号添加编辑权限，就能正常查看和操作文件：

$driveService = new Google\Service\Drive($client);

// 创建电子表格（你的现有代码，确保可正常执行）
$fileMetadata = new Google\Service\Drive\File([
    'name' => 'My Test Spreadsheet',
    'mimeType' => 'application/vnd.google-apps.spreadsheet'
]);
$file = $driveService->files->create($fileMetadata, ['fields' => 'id']);

// 给个人Gmail账号添加编辑权限
$permission = new Google\Service\Drive\Permission([
    'type' => 'user',
    'role' => 'writer',
    'emailAddress' => 'myemail@gmail.com'
]);
try {
    $driveService->permissions->create(
        $file->id,
        $permission,
        ['fields' => 'id']
    );
    echo "权限添加成功，文件ID：{$file->id}";
} catch (Google\Service\Exception $e) {
    echo "权限添加失败：{$e->getMessage()}";
}

3. 若需转移所有权（仅适用于Google Workspace环境） #

如果你使用的是Google Workspace账号，需完成以下配置：

• 给服务账号分配Drive Transfer Owner项目级IAM角色
• 创建权限时添加transferOwnership => true参数：

$permission = new Google\Service\Drive\Permission([
    'type' => 'user',
    'role' => 'owner',
    'emailAddress' => 'your-workspace-email@domain.com'
]);
$driveService->permissions->create(
    $file->id,
    $permission,
    ['fields' => 'id', 'transferOwnership' => true]
);

4. 检查Google Cloud控制台配置 #

• 确保已启用Google Drive API：进入Cloud控制台 → API和服务 → 库，搜索并启用Drive API
• 服务账号IAM角色：给服务账号分配Editor或Drive Admin角色，确保其拥有操作Drive资源的项目级权限

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