You need to enable JavaScript to run this app. 如何使用预设邮箱访问令牌 无需终端用户登录在应用内查看Google Drive文件
优惠活动
大模型
产品
解决方案
定价
更多

如何使用预设邮箱访问令牌 无需终端用户登录在应用内查看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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.13 23:24:03