如何使用预设邮箱访问令牌 无需终端用户登录在应用内查看Google Drive文件
解决方案核心逻辑
你当前使用的是面向终端用户的OAuth2授权模式,权限绑定浏览器登录的Google账号,因此会要求终端用户登录Gmail。替换为服务账号(Service Account)授权模式即可实现需求:服务端全程自行处理Google Drive权限验证,不需要终端用户持有Google账号、也不需要你将Drive文件设为公开,只有你的服务端有权限读取文件内容后转发给站点登录用户。
具体实现步骤
1. 前置Google Cloud配置
- 进入你当前项目的Google Cloud控制台,确认已开启Google Drive API
- 进入「API和服务」-「凭据」页面,创建服务账号,生成JSON格式的密钥文件,保存到PHP项目的非web可访问目录中,避免密钥被公开下载
- 若你使用的是Google Workspace企业邮箱:给服务账号开启「全域权限委派」,随后在Google Workspace管理后台的API权限配置页,给该服务账号的Client ID添加只读Drive范围:
https://www.googleapis.com/auth/drive.readonly,最后配置setSubject参数模拟你本人的邮箱访问Drive - 若你使用的是个人Gmail账号:不需要配置全域委派,直接把你要展示的Drive文件/文件夹,共享给服务账号的邮箱(格式为
xxx@xxx.iam.gserviceaccount.com),权限设为「查看者」即可
2. 基于google drive php client v3的代码实现
首先执行安装命令:composer require google/apiclient:^3.0
核心代码示例:
<?php require __DIR__ . '/vendor/autoload.php'; // 初始化Google客户端 $client = new Google\Client(); // 加载你保存的服务账号密钥文件路径 $client->setAuthConfig('/path/to/your/service-account-secret.json'); // 配置只读权限范围,不需要更高权限 $client->addScope('https://www.googleapis.com/auth/drive.readonly'); // 仅Workspace账号需要加这行,模拟你本人的邮箱访问,个人Gmail账号可删除 $client->setSubject('你的邮箱地址@gmail.com'); // 初始化Drive服务实例 $driveService = new Google\Service\Drive($client); // 示例1:获取指定文件夹下的文件列表 $optParams = [ 'q' => "'你要展示的Drive文件夹ID' in parents and trashed = false", 'fields' => 'files(id, name, mimeType, thumbnailLink, size)' ]; $fileList = $driveService->files->listFiles($optParams)->getFiles(); // 示例2:读取指定文件内容,直接输出给前端用户,不需要用户有Drive权限 $fileId = '目标文件的Drive ID'; $response = $driveService->files->get($fileId, ['alt' => 'media']); $fileContent = $response->getBody()->getContents(); // 输出时设置对应Content-Type即可,例如下载/预览文件 // header('Content-Type: ' . $fileMimeType); // echo $fileContent; ?>
3. 额外优化建议
- 建议对Drive API的返回结果加服务端缓存,降低API配额消耗,提升用户访问速度
- 所有读取Drive的操作都放在服务端处理,不要直接返回Drive原始链接给前端,避免链接泄露导致文件被未授权访问
内容的提问来源于stack exchange,提问作者sowmya vejerla
相关产品推荐
相关产品推荐

