Google Calendar API PHP 集成与 OAuth 认证指南

composer require google/apiclient:^2.0

<?php

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

// 确保此应用在命令行环境下运行，因为示例的授权流程是基于命令行交互的。
if (php_sapi_name() != 'cli') {
    throw new Exception('This application must be run on the command line.');
}

/**
 * 返回一个已授权的 API 客户端对象。
 * @return Google_Client 已授权的客户端对象
 */
function getClient()
{
    $client = new Google_Client();
    $client->setApplicationName('Google Calendar API PHP Quickstart'); // 设置应用程序名称
    $client->setScopes(Google_Service_Calendar::CALENDAR_READONLY); // 设置所需的 API 范围，此处为只读日历权限
    $client->setAuthConfig('credentials.json'); // 加载 OAuth 客户端凭据文件
    $client->setAccessType('offline'); // 允许在用户不在线时刷新访问令牌
    $client->setPrompt('select_account consent'); // 每次都提示用户选择账户并授权

    // 尝试从文件加载之前保存的访问令牌。
    // token.json 文件存储用户的访问和刷新令牌，并在首次授权流程完成后自动创建。
    $tokenPath = 'token.json';
    if (file_exists($tokenPath)) {
        $accessToken = json_decode(file_get_contents($tokenPath), true);
        $client->setAccessToken($accessToken);
    }

    // 如果没有之前保存的令牌或令牌已过期。
    if ($client->isAccessTokenExpired()) {
        // 如果有刷新令牌，则尝试刷新访问令牌。
        if ($client->getRefreshToken()) {
            $client->fetchAccessTokenWithRefreshToken($client->getRefreshToken());
        } else {
            // 请求用户授权。
            $authUrl = $client->createAuthUrl();
            printf("请在浏览器中打开以下链接进行授权:\n%s\n", $authUrl);
            print '输入验证码: ';
            $authCode = trim(fgets(STDIN)); // 从命令行读取用户输入的验证码

            // 使用授权码交换访问令牌。
            $accessToken = $client->fetchAccessTokenWithAuthCode($authCode);
            $client->setAccessToken($accessToken);

            // 检查是否有错误。
            if (array_key_exists('error', $accessToken)) {
                throw new Exception(join(', ', $accessToken));
            }
        }
        // 保存令牌到文件。
        if (!file_exists(dirname($tokenPath))) {
            mkdir(dirname($tokenPath), 0700, true);
        }
        file_put_contents($tokenPath, json_encode($client->getAccessToken()));
    }
    return $client;
}

<?php
// ... (getClient 函数和 require 语句在上方已定义)

// 获取 API 客户端并构建服务对象。
$client = getClient();
$service = new Google_Service_Calendar($client);

// 打印用户日历上的接下来 10 个事件。
$calendarId = 'primary'; // 'primary' 指代用户的默认日历
$optParams = array(
  'maxResults' => 10, // 最多返回 10 个事件
  'orderBy' => 'startTime', // 按开始时间排序
  'singleEvents' => true, // 展开重复事件
  'timeMin' => date('c'), // 只获取当前时间之后的事件
);
$results = $service->events->listEvents($calendarId, $optParams);
$events = $results->getItems();

if (empty($events)) {
    print "未找到任何即将发生的事件。\n";
} else {
    print "即将发生的事件:\n";
    foreach ($events as $event) {
        $start = $event->start->dateTime;
        if (empty($start)) {
            $start = $event->start->date;
        }
        printf("%s (%s)\n", $event->getSummary(), $start);
    }
}