Google App Scripts 什么是“分页”调用？答案

【问题标题】：Google App Scripts what is a 'paged' call?Google App Scripts 什么是“分页”调用？
【发布时间】：2019-11-20 20:53:27
【问题描述】：

什么是“分页”呼叫？

整个页面都提到了https://developers.google.com/apps-script/reference/gmail/gmail-app.html#search(String)

是否有任何关于什么是“分页”调用的文档？为什么他们提到它就像我应该能够在其他地方读到的一样？

它说了七次

请使用“分页”调用，并指定线程范围以在每次调用中检索。

我理解将其分解成碎片的概念，但他们说“分页”调用是否有关于此的一些文档或某种我应该理解的俚语？

【问题讨论】：

看here
@Cooper 是的，我看到了这个问题，这实际上是促使我提出这个问题的原因，因为我从未注意到一页上 7 个地方的文档提到了这个短语。是否有关于“分页”呼叫在某处的官方定义？这只是我应该知道的某种程序员俚语，还是网上有一些关于 THE 'paged' call 到底是什么的参考资料？
使用搜索重复问题并使用[google-apps-script] 'paged' call进行搜索
很多时候你必须在搜索集合时使用页面标记，我认为这就是他们所说的。我也不知道是什么。
@Cooper 是的，这就是我提出这个问题的方式，我知道很多问题都提到了它，但没有人定义过“分页”呼叫到底是什么？我的意思是我了解如何解决这些特定问题的概念，但他们谈论它就像是某种官方的东西，所以我想问题是这只是一个修辞格programmer slang 或者在某个地方实际上有文档无论paged call 是什么，也许有一个我们不知道的分页调用函数，或者我可以在俚语词典上找到分页调用。

标签： google-apps-script gmail

【解决方案1】：

这是指页面令牌的概念，您应该可以将其作为参数添加到您的请求中。有一些更好的例子here。不幸的是，没有真正解释什么是页面令牌的页面，所以我会尽力而为。

假设我调用了 Gmail API，我想要一个我帐户中所有电子邮件的列表。这对于一个请求来说太多了，所以我一次请求 1,000 个，从我最近的消息开始。当我请求 1,000 条消息时，Google 将向我返回 page token 以及我请求的 1,000 条结果。如果我想要最近的 1,000 封电子邮件，我需要将我从之前的请求中获得的 pageToken 与我的新请求一起发送。

把它想象成翻阅一本书，您可以在其中决定一页上有多少“单词”（使用maxResults 参数）。当您停止从 Google 获取 pageToken 时，您就已经读完了这本书，并且已经请求了所有可用信息。

pageToken 似乎只在Gmail Advanced Service 上可用。

【讨论】：

Gmail 高级服务链接中 pageToken 的文档在哪里？此外，我似乎找不到 Drive...Gmail... 高级对象的 API？
检查here。

【解决方案2】：

恕我直言，务实的解释

如果线程大小未知，并且可能非常大，请使用“分页”调用，并指定要在每次调用中检索的线程范围。

是用search(query, start, max)代替query(query)

虽然理解每个技术术语可能会很有帮助，但更重要的是要考虑到整个陈述和上下文来解释它们。

【讨论】：