Google Drive API V3推送通知订阅遇400错误：pageToken必填疑问

我之前也踩过这个坑！你碰到的这个问题其实是文档描述的细节没说透——虽然官方文档标注pageToken不是必填项，但第一次创建变更订阅时必须提供这个参数，原因是Google Drive需要知道从哪个变更节点开始监听你的文件变化。

问题根源 #

changes/watch接口本质上是基于changes/list接口的持续监听扩展，初始的pageToken用来指定监听的起始位置。文档里说的“非必填”其实是针对更新已有订阅的场景，第一次创建订阅时这个参数是隐性必填的。

解决步骤 #

1. 获取初始pageToken
   先调用changes/list接口发送GET请求：

   GET https://www.googleapis.com/drive/v3/changes
   

   不需要额外参数（也可以加pageSize=1来快速返回结果），响应体里的nextPageToken就是你需要的pageToken。

2. 修改watch请求体
   把获取到的nextPageToken添加到你的POST请求体中：

   {
     "id": "你生成的自定义ID",
     "type": "web_hook",
     "address": "你的回调地址",
     "pageToken": "刚才获取的nextPageToken值"
   }
   

3. 重新发送请求
   带上正确的请求头（Content-type: application/json和Authorization: Bearer 你的授权token）重新发送POST到https://www.googleapis.com/drive/v3/changes/watch，应该就能成功创建订阅了。

额外注意点 #

• 确保你的授权token拥有足够的权限，至少需要drive.readonly权限，否则获取pageToken时会返回权限错误。
• 你的回调地址必须是公网可访问的，本地localhost无法被Google的服务器触发回调，可使用ngrok等工具做本地端口转发测试。

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