PHP调用Google API如何实现无实体用户登录访问服务

完全可以仅通过PHP代码完成鉴权，无需实体用户介入即可调用Gmail、Drive的所有API接口。

Gmail服务对服务账号的支持存在明确限制：

• 服务账号本身是独立的虚拟账号身份，默认不属于任何个人用户
• 服务账号的全域委派（DWD）能力仅对Google Workspace企业域账号开放，普通个人Gmail账号无法配置该权限，所以不可能通过服务账号直接以个人自有账号的身份发送Gmail邮件，你之前卡在这里属于官方规则限制，不是配置问题。

你已经在数据库中存储了账号对应的access_token和refresh_token，不需要再走任何用户跳转授权的流程，直接用Google官方PHP客户端即可实现自动鉴权、自动刷新过期token，全程无人工介入，步骤如下：

• 安装官方依赖：在项目目录执行composer命令安装Google API PHP客户端

composer require google/apiclient:^2.0

• 初始化客户端并注入已存储的凭证，核心逻辑参考如下代码：

require __DIR__ . '/vendor/autoload.php';

// 初始化客户端
$client = new Google\Client();
// 填入你在Google Cloud控制台创建OAuth2客户端时生成的ID和密钥
$client->setClientId('你的OAuth2客户端ID');
$client->setClientSecret('你的OAuth2客户端密钥');
// 按需配置需要调用的接口权限范围
$client->addScope(Google\Service\Gmail::MAIL_GOOGLE_COM);
$client->addScope(Google\Service\Drive::DRIVE);
$client->setAccessType('offline');

// 从数据库读取你之前存储的token信息，需包含access_token、refresh_token、过期时间、创建时间字段
$storedToken = [
    'access_token' => '数据库存储的access_token值',
    'refresh_token' => '数据库存储的refresh_token值',
    'expires_in' => 3599,
    'created' => 1234567890, // 替换为你存储的token创建时间戳
];
$client->setAccessToken($storedToken);

// 自动检测token是否过期，过期则自动用refresh_token换取新的有效token
if ($client->isAccessTokenExpired()) {
    $newToken = $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
    // 将新生成的token更新回数据库，供后续请求使用
    // 示例逻辑：$db->query("UPDATE google_account_tokens SET token = ? WHERE id = ?", [json_encode($newToken), $accountId]);
}

• 初始化对应服务实例直接调用接口即可：
  • 调用Gmail服务：$gmailService = new Google\Service\Gmail($client); 后续可直接调用发信、读信、管理邮件等所有接口
  • 调用Drive服务：$driveService = new Google\Service\Drive($client); 调用逻辑和你之前用服务账号对接Drive的逻辑完全一致

• 你存储的refresh_token默认长期有效，仅当你手动在Google账号的第三方授权管理中撤销对应客户端权限、或删除对应OAuth2客户端时才会失效
• 如果你之前存储的token对应的权限范围不包含Gmail相关权限，仅需要第一次手动走一次OAuth授权流程，拿到包含Gmail权限的新refresh_token存入数据库即可，后续全程无需人工操作
• 个人Gmail账号不要尝试通过服务账号实现无交互发信，该路径官方完全不支持，使用refresh_token自动刷新的方案是个人账号场景下唯一稳定的无交互实现方式

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