自动化Google Drive API访问：持久化与刷新令牌机制

<?php
require __DIR__ . '/vendor/autoload.php'; // 引入Google API客户端库

session_start(); // 启用会话管理

// 1. 初始化Google客户端
$client = new Google_Client();
$client->setApplicationName('Google Drive API PHP Quickstart');
// 设置您的重定向URI，这必须与Google Cloud Console中配置的完全一致
$client->setRedirectUri('http://localhost/callback.php'); 
// 设置所需的权限范围，例如Google_Service_Drive::DRIVE表示完全访问Google Drive
$client->setScopes(Google_Service_Drive::DRIVE);
// 加载您的OAuth 2.0凭据文件
$client->setAuthConfig('credentials.json');
// 关键：请求离线访问权限，以获取刷新令牌
$client->setAccessType('offline');
// 关键：强制用户选择账户并同意授权，确保首次获取刷新令牌
$client->setPrompt('select_account consent');

$tokenPath = 'token.json'; // 存储令牌的文件路径

// 2. 处理Google授权回调
if (isset($_GET['code'])) {
    try {
        // 使用授权码交换访问令牌和刷新令牌
        $accessToken = $client->fetchAccessTokenWithAuthCode($_GET['code']);
        $client->setAccessToken($accessToken);

        // 检查是否成功获取到刷新令牌
        if (isset($accessToken['refresh_token'])) {
            // 将整个令牌数组（包括刷新令牌）保存到文件
            // 建议将此令牌安全地存储在数据库中，而不是纯文本文件
            file_put_contents($tokenPath, json_encode($accessToken));
            echo "刷新令牌已成功获取并保存！<br>";
            echo "您现在可以关闭此页面，并使用自动化脚本进行操作。";
        } else {
            echo "未获取到刷新令牌。请确保 `setAccessType('offline')` 已设置且用户授予了离线访问权限。<br>";
            echo "当前获取的令牌信息：<pre>" . json_encode($accessToken, JSON_PRETTY_PRINT) . "</pre>";
        }

        // 清除会话中的旧令牌信息（如果存在）
        unset($_SESSION['token']);

    } catch (Exception $e) {
        echo "令牌交换失败: " . $e->getMessage();
    }
    exit; // 处理完回调后退出
}

// 3. 引导用户进行授权（如果尚未授权）
if (!file_exists($tokenPath)) { // 如果尚未保存令牌文件
    $authUrl = $client->createAuthUrl();
    echo "<a href='$authUrl'>点击此处进行Google账户授权</a>";
} else {
    // 如果令牌文件已存在，表示已完成授权
    echo "您已完成Google账户授权，刷新令牌已保存。<br>";
    echo "现在可以使用自动化脚本进行操作。";
}
?>

{
  "web": {
    "client_id": "YOUR_CLIENT_ID.apps.googleusercontent.com",
    "project_id": "YOUR_PROJECT_ID",
    "auth_uri": "https://accounts.google.com/o/oauth2/auth",
    "token_uri": "https://oauth2.googleapis.com/token",
    "auth_provider_x509_cert_url": "https://www.googleapis.com/oauth2/v1/certs",
    "client_secret": "YOUR_CLIENT_SECRET",
    "redirect_uris": [
      "http://localhost/callback.php" // 必须与代码中的setRedirectUri一致
    ],
    "javascript_origins": [
      "http://localhost"
    ]
  }
}

<?php
require __DIR__ . '/vendor/autoload.php'; // 引入Google API客户端库

// 1. 初始化Google客户端
$client = new Google_Client();
$client->setApplicationName('Google Drive API PHP Quickstart');
$client->setScopes(Google_Service_Drive::DRIVE);
$client->setAuthConfig('credentials.json'); // 仍然需要凭据文件来识别您的应用

$tokenPath = 'token.json'; // 存储令牌的文件路径

// 2. 加载已保存的令牌（包括刷新令牌）
if (file_exists($tokenPath)) {
    $accessToken = json_decode(file_get_contents($tokenPath), true);
    $client->setAccessToken($accessToken);
} else {
    die("错误：未找到保存的令牌文件。请先运行 initial_auth.php 进行授权。");
}

// 3. 检查访问令牌是否过期，如果过期则使用刷新令牌获取新令牌
// Google客户端库通常会自动处理此逻辑，但明确调用有助于理解
if ($client->isAccessTokenExpired()) {
    echo "访问令牌已过期，正在尝试使用刷新令牌获取新令牌...<br>";
    try {
        // 使用刷新令牌获取新的访问令牌
        // fetchAccessTokenWithRefreshToken() 会返回新的 access_token，并可能更新 refresh_token (尽管Google很少改变refresh_token)
        $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
        // 更新保存的令牌文件，确保始终存储最新的令牌信息（包括潜在的新刷新令牌）
        file_put_contents($tokenPath, json_encode($client->getAccessToken()));
        echo "新访问令牌已获取并更新。<br>";
    } catch (Exception $e) {
        die("无法刷新访问令牌。可能原因：刷新令牌已失效或被撤销。需要重新进行用户授权。错误: " . $e->getMessage());
    }
}

// 4. 执行Google Drive API操作
try {
    $service = new Google_Service_Drive($client);

    // 示例：上传一个文件
    $filePath = 'path/to/your/local/file.txt'; // 替换为你要上传的文件路径
    if (!file_exists($filePath)) {
        die("错误：本地文件 '{$filePath}' 不存在。");
    }

    $fileMetadata = new Google_Service_Drive_DriveFile([
        'name' => 'MyAutomatedUpload.txt', // 在Google Drive中显示的文件名
        'mimeType' => 'text/plain'
    ]);

    $content = file_get_contents($filePath);
    $file = $service->files->create($fileMetadata, [
        'data' => $content,
        'mimeType' => 'text/plain',
        'uploadType' => 'multipart',
        'fields' => 'id'
    ]);

    printf("文件 '%s' (ID: %s) 已成功上传到Google Drive。\n", $fileMetadata->getName(), $file->id);

} catch (Google\Service\Exception $e) {
    echo "Google Drive API错误: " . $e->getMessage();
} catch (Exception $e) {
    echo "发生错误: " . $e->getMessage();
}
?>