扩充项标识

如果要将为一个集合创建的定制扩充项应用于另一个集合，那么必须知道在创建扩充项时为其生成的唯一标识。 使用 API 从正在使用定制扩充项的项目中 列示扩充项。 返回的列表包含扩充项标识信息。

对于预构建的扩充项，唯一标识不会更改。 下表列出了与每个预构建的扩充项类型相关联的标识，并标识了支持扩充项的集合语言。 除非扩充项支持集合语言，否则无法将扩充项应用于集合。

有关所有受支持语言的更多信息，请参阅 语言支持。

使用 API 应用扩充项

要使用API进行数据丰富，请完成以下步骤：

1. 确定端点的 URL 以及部署的令牌或API密钥。

   有关更多信息，请参阅 使用 API 构建定制应用程序。

2. 获取项目的项目标识。

   从产品用户界面，转至“集成和部署 > 查看 API 信息”页面，然后复制项目标识。

3. 如果您不知道要对其应用扩充项的集合的标识，请获取集合列表以进行查找。

   例如：

   GET $authentication $url/v2/projects/$project_id/collections?version=2019-11-22
   

   将返回 collection_id。

4. 发送 GET 请求以返回列出所应用扩充项的集合的配置。

   例如：

   GET $authentication $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22
   

   有关预构建扩充项的扩充项标识，请参阅 扩充项标识。

5. 添加要应用的扩充项。

   例如，要添加 关键字 扩充项，可以在扩充项列表中包含该扩充项。 首先，从表中获取其标识。

   关键字扩充项标识为 701db916-fc83-57ab-0000-000000000018。 要指示您要将“关键字”扩充项应用于集合中文档的 text 字段中的内容，可以 JSON 格式表示该内容，如下所示:

   {
       "enrichment_id" : "701db916-fc83-57ab-0000-000000000018",
       "fields" : [ "text" ]
   }
   

   您指定的任何扩充项都将替换缺省扩充项。 因此，如果要保留缺省扩充项，请不要忘记将其包含在应用于集合的扩充项列表中。 有关每种项目类型的缺省扩充项的列表，请参阅 每种项目类型的缺省扩充项。

   例如，要保留 实体 扩充项并添加 关键字 扩充项，可以在请求主体中指定以下内容。

   "enrichments": [
     {
       "enrichment_id": "701db916-fc83-57ab-0000-00000000001e",
       "fields": [
         "text"
       ]
     },
     {
       "enrichment_id": "701db916-fc83-57ab-0000-000000000018",
       "fields": [
         "text"
       ]
     }
   ]
   

6. 使用 update collection 方法提交更新后的 JSON 请求主体，以将扩充项应用于集合。

   例如：

   POST $authentication -d '$requestBody' $url/v2/projects/$project_id/collections/$collection_id?version=2019-11-22