对话API允许您以编程方式检索和提交Bazaarvoice对话数据以在应用程序中使用。要了解更多信息,请参阅对话API文档主页

内容

+显示 ——隐藏

本教程描述如何使用限制而且抵消参数来分页API结果集。

简介

分页是将总结果集划分为更小的子集以便在用户界面中显示的过程。

限制和抵消

Bazaarvoice平台每次使用对话API发出请求时都会计算一个总结果集。方法对总结果集进行分页限制而且抵消参数。限制控制响应请求时将返回的结果的计数。抵消标识在总结果中开始返回结果的位置。通过组合这两个参数,可以遍历整个结果集。

参数 描述
限制 每个请求返回的最大记录数。默认值为10,最大值为100。
抵消 返回结果所在的索引。默认情况下,在发出查询时,索引从0开始。使用限制= 100抵消= 0返回结果0-99。当把这个改为抵消= 1,返回结果1 ~ 100。最大支持300000。
限制而且抵消仅用于有机流量(用户手动单击链接)。任何其他使用都会导致性能下降,并可能导致对API使用的限制或限制。

基本的分页

下表演示了基本分页。在本例中,每个页面显示相同数量的结果。突出显示的部分描述了将为给定页面返回的子集。

请求/页面 参数 总结果计数
1 限制=5抵消=0 0 1 2 3 45 6 7 8 9 10 11 12 13 14
2 限制=5抵消=5 0 1 2 3 45 6 7 8 910 11 12 13 14
3. 限制=5抵消=10 0 1 2 3 4 5 6 7 8 910 11 12 13 14

最佳实践分页

作为最佳实践,我们建议在第一页上显示较少的消费者生成内容(CGC),然后在用户通过发起分页表示有兴趣阅读CGC后显示更多内容。具体来说,你应该在第一页显示不少于8个结果,在后续页面显示最多30个结果。

在这个例子中,第一页显示的结果数量比后面的页面要少。可以通过修改限制而且抵消参数值。突出显示的部分描述了将为给定页面返回的子集。

请求/页面 参数 总结果计数
1 限制=5抵消=0 0 1 2 3 45 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24
2 限制=10抵消=5 0 1 2 3 45 6 7 8 9 10 11 12 13 1415 16 17 18 19 20 21 22 23 24
3. 限制=10抵消=15 0 12 3 4 5 6 7 8 9 10 11 12 13 1415 16 17 18 19 20 21 22 23 24
为了简单起见,上面的例子在第一页上有5个结果,然后在后续页面上有10个结果。我们的官方建议是在第一页上不少于8个结果,然后在后续页面上最多30个结果。