集合 API 注释

下表显示了 v1 和 v2 集合 API 之间的重要差异。

查询注释

• v2 查询将返回项目中所有集合的结果。 要将查询限制为仅使用项目中的特定集合，请使用 collection_ids 查询参数。 无法使用一个 v2 查询请求来查询添加到不同项目的多个集合。

• v2 结果包含 confidence 字段，但不包含 score 字段。

  置信度分数替换了 v1中的分数信息，但保留了分数以实现向后兼容性。 在 v2中，仅返回置信度字段。

• 使用 POST 调用 (而不是 GET 调用) 来提交具有 v2的查询。

• v1 查询接受许多参数。 查询参数比较 表将 v1 参数映射到 v2 参数。

  查询参数比较

  v1 参数	v2 参数	注释
  不适用	collection_ids	在 v2 中使用此参数来指定集合标识。
  过滤器	过滤器	相同的表达式语言。
  查询	查询	相同的表达式语言。
  natural_language_query	natural_language_query	无注释。
  passages	passages	通道格式已更改，并在 v2中进行了增强。 passages:true 参数已更改为 passages.enable:true。 除了 count，characters 和 fields 选项外，您还可以指定 per_document(按文档质量对文档进行排序)，然后返回每个文档排名最高的段落。 您还可以指定 find_answers 以返回每个段落的答案对象，其中包含查询的简明答案。
  汇总	汇总	相同的表达式语言。
  计数	计数	无注释。
  offset	offset	无注释。
  return	return	无注释。
  排序	排序	无注释。
  突出显示	突出显示	如果 passages.enabled 和 passages.per_document 为 true，那么将针对每个文档返回段落而不是突出显示。
  spelling_建议	spelling_建议	无注释。
  删除重复数据	不适用	v2 中不支持。
  similar	similar	在 v2中更改了格式。 similar:true 参数已更改为 similar.enable:true。 document_ids 和 fields 参数已从字符串更改为字符串数组。 如果 enabled 为 true，那么现在需要 document_ids 参数。
  偏差	不适用	v2 中不支持。