使用PHP和Google Drive API向目标受众共享Google表格

可行性结论 #

完全可行。Google Drive API默认复制文件时不会继承原文件的非所有者权限（包括目标受众的权限），所以需要手动提取原文件的目标受众权限，再批量添加到新文件上。

具体实现步骤 #

1. 提取原文件的目标受众权限 #

先调用Permissions.list接口获取原文件的所有权限，筛选出属于目标受众的条目（通常是domain类型的域受众或group类型的群组受众）。

PHP代码示例：

// 初始化Drive服务（假设你已完成授权配置）
$driveService = new Google_Service_Drive($client);

$sourceFileId = "你的原文件ID";
// 获取权限，只返回需要的字段减少数据量
$permissionList = $driveService->permissions->listPermissions(
    $sourceFileId,
    ['fields' => 'permissions(id,type,role,emailAddress,domain)']
);

// 筛选目标受众权限
$targetPermissions = [];
foreach ($permissionList->getPermissions() as $perm) {
    // 匹配域或群组类型的权限
    if (in_array($perm->getType(), ['domain', 'group'])) {
        $targetPermissions[] = $perm;
    }
}

2. 给新复制的文件批量添加权限 #

遍历筛选出的权限条目，调用Permissions.create接口将权限应用到新文件上。

PHP代码示例：

$newFileId = "复制后的新文件ID";

foreach ($targetPermissions as $sourcePerm) {
    $newPerm = new Google_Service_Drive_Permission();
    $newPerm->setType($sourcePerm->getType());
    $newPerm->setRole($sourcePerm->getRole());

    // 根据权限类型设置对应参数
    if ($sourcePerm->getType() === 'domain') {
        $newPerm->setDomain($sourcePerm->getDomain());
    } elseif ($sourcePerm->getType() === 'group') {
        $newPerm->setEmailAddress($sourcePerm->getEmailAddress());
    }

    // 创建权限，可选关闭通知邮件
    $driveService->permissions->create(
        $newFileId,
        $newPerm,
        ['sendNotificationEmail' => false]
    );
}

关键注意点 #

• 如果原文件在共享驱动器中，调用接口时需要添加supportsAllDrives: true参数，否则会报错。
• 可以先检查新文件是否已有对应权限，避免重复创建（调用Permissions.list对比即可）。
• sendNotificationEmail参数设为true会给受众发送共享通知，根据业务需求调整。

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