API的对话:检索并提交消费者生成的内容(CGC),检索您的产品目录和关于CGC的统计信息。
分页
对话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个结果。