使用OAuth工具调用ChromeOS设备API时nextPageToken重复返回相同结果

可能的核心原因 #

• 令牌上下文差异
  OAuth Playground和Apps Script OAuth库获取的访问令牌，可能缺少Google目录API分页所需的完整会话上下文。API Explorer与原生Apps Script接口属于Google官方工具，会自动关联G Suite管理员账号的完整权限上下文，而第三方OAuth客户端（如Playground、自定义OAuth库）的令牌仅携带基础权限，无法让API正确关联分页会话状态，导致重复返回第一页数据。
  可验证令牌的scope、aud（受众）字段是否与API Explorer获取的令牌完全一致——比如部分场景下，第三方令牌的aud可能不是API端点的完整URL，导致API无法识别分页请求的关联关系。

• 请求参数构造错误
  确认nextPageToken的传递方式：必须将其作为pageToken查询参数附加到URL末尾，格式应为：

  https://admin.googleapis.com/admin/directory/v1/customer/my_customer/devices/chromeos?pageToken={your_next_page_token}
  

  若错误地将pageToken放在请求体或其他位置，API会忽略该参数，直接返回第一页数据。此外，检查是否在后续请求中意外修改了maxResults参数，导致结果集匹配第一页。

• OAuth库的会话重置问题
  Apps Script OAuth库在令牌刷新时，可能重置了与API的会话关联。而原生Apps Script接口由Google内部维护，会自动保留分页所需的会话状态，因此能正常获取下一页数据。尝试复用同一令牌执行分页请求，而非每次刷新令牌，验证是否解决问题。

验证步骤 #

1. 解析令牌：用JWT解析工具对比Playground、API Explorer获取的令牌，检查scope、aud、sub字段是否存在差异。
2. 手动请求验证：使用curl工具，用Playground的令牌先执行第一页请求，拿到nextPageToken后立即执行带pageToken的第二页请求，判断是否返回重复结果。若curl中同样重复，说明是令牌或API端逻辑问题；若curl正常，则是Playground/OAuth库的请求构造问题。
3. 对比请求日志：在Apps Script中，分别打印原生接口与OAuth库的请求头、完整URL参数，排查是否存在参数遗漏或格式错误。

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