如何解除Google Drive文件限制、获取webContentLink并设为私有？PHP setExpirationTime疑问

问题说明 #

我需要解除Google Drive文件的访问限制，获取它的webContentLink，之后再把文件重新设为私有。可以通过直接切换私有状态，或者给权限设置过期时间来实现，但PHP版Google Drive API的setExpirationTime函数文档不完善，搞不懂参数怎么传。

最初尝试的代码 #

/**
 * 获取文件下载链接
 * @param  string $fileId
 * @return string 文件下载链接
 */
public function getFileDownloadLink(string $fileId, int $linkExpirationTimeInSeconds) {

    $this->changeFilePermissions($fileId, $linkExpirationTimeInSeconds);

    /**
     * @var \Google\Service\Drive\DriveFile $file
     */
    $file = $this->service->files->get(
        $fileId, 
        array('fields' => 'webContentLink')
    );
    
    return $file->getWebContentLink();
}

/**
 * 处理文件权限
 * @param  string $fileId 文件ID
 * @return void
 */
private function changeFilePermissions(string $fileId, int $linkExpirationTimeInSeconds) {
    $permission = new \Google\Service\Drive\Permission();
    $permission->setRole('reader');
    $permission->setType('anyone');
    
    // 尝试过的写法，但无效
    $permission->setExpirationTime(date('Y-m-d\TH:i:s', time() + $linkExpirationTimeInSeconds) . 'Z');
    $this->service->permissions->create($fileId, $permission);
}

手动绕过的临时方案 #

文件下载函数 #

public function downloadFileDriveServer(string $fileId) {

    $this->setPermissionPublic($fileId);

    /**
     * @var \Google\Service\Drive\DriveFile $file
     */
    $file = $this->service->files->get(
        $fileId, 
        array('fields' => 'webContentLink')
    );
    
    return $file->getWebContentLink();
}

设置文件公开 #

private function setPermissionPublic(string $fileId) {
    // 短时间内将文件设为公开
    $permission = new \Google\Service\Drive\Permission();
    $permission->setRole('reader');
    $permission->setType('anyone');
    $permission = $this->service->permissions->create($fileId, $permission);
}

恢复文件私有 #

public function setPermissionPrivate(string $fileId) {
    $this->service->permissions->delete($fileId, "anyoneWithLink");
}

调用代码（index.php） #

echo $fileController->downloadFileDriveServer($id);

sleep(30);

$fileController->setPermissionPrivate($id);

正确解决方法 #

1. 修复setExpirationTime参数问题 #

setExpirationTime需要传入RFC 3339标准格式的时间字符串，推荐用PHP的DateTime类生成，避免手动拼接出错。另外注意：普通免费Google账号不支持权限过期功能，只有G Suite/Workspace账号可以使用该特性。

修正后的权限处理函数：

private function changeFilePermissions(string $fileId, int $linkExpirationTimeInSeconds) {
    $permission = new \Google\Service\Drive\Permission();
    $permission->setRole('reader');
    $permission->setType('anyone');
    
    // 生成符合RFC 3339的过期时间
    $expirationDate = (new DateTime())->add(new DateInterval("PT{$linkExpirationTimeInSeconds}S"));
    $permission->setExpirationTime($expirationDate->format(DateTimeInterface::RFC3339));
    
    // 创建权限时可关闭通知邮件（可选）
    $this->service->permissions->create($fileId, $permission, [
        'sendNotificationEmail' => false
    ]);
}

2. 修复手动私有恢复的问题 #

直接用"anyoneWithLink"作为权限ID删除不可靠，正确做法是先列出文件的所有权限，找到type为anyone的权限ID再删除：

public function setPermissionPrivate(string $fileId) {
    // 获取文件所有权限
    $permissions = $this->service->permissions->listPermissions($fileId, ['fields' => 'permissions(id,type)']);
    foreach ($permissions->getPermissions() as $perm) {
        if ($perm->getType() === 'anyone') {
            $this->service->permissions->delete($fileId, $perm->getId());
        }
    }
}

3. 临时方案的弊端 #

用sleep(30)的方式不可靠：如果用户在30秒内没完成下载，链接就会失效；如果脚本意外中断，文件会一直处于公开状态。使用权限过期的方式更安全，无需手动干预，到期后自动恢复私有。

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