Google Calendar API未返回全部事件，如何获取当前日期活动？

你这问题核心是没给API请求指定时间范围，Google Calendar API的events.list接口默认只会返回有限时间范围内的事件，默认范围不包含当前及未来的新事件；另外如果事件总数超过250个，还需要用分页令牌来拉取全部内容。

1. 先添加时间范围参数 #

修改你的请求URL，加上timeMin和timeMax参数，明确你要获取的事件时间区间。比如要拉取过去1年到未来1年的事件：

// 生成ISO8601格式的UTC时间，urlencode避免编码问题
$timeMin = urlencode(date('c', strtotime('-1 year')));
$timeMax = urlencode(date('c', strtotime('+1 year')));

// 拼接带时间范围的请求地址
$requestUrl = "https://www.googleapis.com/calendar/v3/calendars/{$calName}/events?key={$key}&timeMin={$timeMin}&timeMax={$timeMax}";
$json = file_get_contents($requestUrl);

如果只需要未来的活动，直接把timeMin设为当前时间：$timeMin = urlencode(date('c'));

2. 处理分页（当事件超过250个时） #

Google Calendar API单页最多返回250个事件，如果符合时间范围的事件总数超过这个数，接口会返回nextPageToken，需要循环请求直到没有分页令牌为止。完整代码示例：

$allEvents = [];
$pageToken = null;
// 定义时间范围：当前时间到未来1年
$timeMin = urlencode(date('c'));
$timeMax = urlencode(date('c', strtotime('+1 year')));

do {
    $requestUrl = "https://www.googleapis.com/calendar/v3/calendars/{$calName}/events?key={$key}&timeMin={$timeMin}&timeMax={$timeMax}";
    // 如果有分页令牌，拼到请求里
    if ($pageToken) {
        $requestUrl .= "&pageToken=" . urlencode($pageToken);
    }
    
    $json = file_get_contents($requestUrl);
    $data = json_decode($json, JSON_OBJECT_AS_ARRAY);
    
    // 合并当前页的事件到总列表
    if (isset($data['items'])) {
        $allEvents = array_merge($allEvents, $data['items']);
    }
    
    // 更新分页令牌，没有的话就结束循环
    $pageToken = $data['nextPageToken'] ?? null;
} while ($pageToken);

// 遍历输出所有事件的开始时间
foreach ($allEvents as $event) {
    print_r($event['start']);
    echo "<br/>";
}

额外检查点 #

• 确认你的API密钥有权访问该日历，如果是私有日历，仅用API密钥不行，得用OAuth 2.0授权
• 检查日历里的当前日期事件是否确实存在，没有被设为私密或删除

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