调用Google API获取文件变更时nextPageToken缺失问题咨询

我在Google官方指南中看到如下代码：

if 'newStartPageToken' in response:
    # Last page, save this token for the next polling interval
    saved_start_page_token = response.get('newStartPageToken')
page_token = response.get('nextPageToken')

但在实际调用场景中，响应字典里始终不存在nextPageToken，响应内容示例如下：

{
    'kind': 'drive#changeList',
    'newStartPageToken': '21',
    'changes': 
    [{
        'kind': 'drive#change',
        'removed': False,
        'file': 
        {
            'kind': 'drive#file',
            'mimeType': 'application/vnd.google-apps.spreadsheet',
            'id': '1fArmA72nxcQVv_gr31MHv4RV2e_n8j79-xvr6FOWDDc',
            'name': 'Canalservice'
        },
        'fileId': '1fArmA72nxcQVv_gr31MHv4RV2e_n8j79-xvr6FOWDDc',
        'time': '2023-03-18T08:39:23.049Z',
        'type': 'file',
        'changeType': 'file'
    }]
}

这导致循环总是提前结束，请问我忽略了什么要点？

• nextPageToken的存在逻辑：Google Drive API仅在当前响应未返回所有匹配的变更时，才会返回nextPageToken。如果响应里没有这个字段，说明当前请求已经拉取完所有可用的变更数据，循环结束是符合API设计的正常行为，并非提前结束。

• newStartPageToken的作用：这个字段是给你下一次轮询变更用的起始标记，不是当前分页的下一页令牌。当后续需要检查是否有新的变更时，应该用这个newStartPageToken作为请求参数，而非试图用它继续当前的分页循环。

• 正确的循环逻辑框架：循环应基于page_token是否存在来控制，示例代码如下：

saved_start_page_token = "你的初始起始令牌"
page_token = None

while True:
    # 发起变更列表请求
    response = drive.changes.list(
        pageToken=page_token or saved_start_page_token,
        fields='*'
    ).execute()
    
    # 处理当前页的变更数据
    for change in response.get('changes', []):
        # 这里写你的业务处理逻辑，比如打印变更ID或更新本地数据
        print(f"处理变更文件ID: {change['fileId']}")
    
    # 保存下次轮询的起始令牌
    if 'newStartPageToken' in response:
        saved_start_page_token = response['newStartPageToken']
    
    # 获取下一页令牌，若无则退出循环
    page_token = response.get('nextPageToken')
    if not page_token:
        break

• 关于"提前结束"的误解：如果预期还有更多变更但未返回，大概率是当前起始令牌对应的所有历史变更已被拉取完毕。此时应保存newStartPageToken，之后定期用它请求新的变更，而非继续当前循环。

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