Google Cloud Natural Language 扩展程序

您正在查看 Apigee Edge 文档。
前往 Apigee X 文档。 信息

版本 1.4.3

提供对 Google Cloud Natural Language API 的访问权限。

使用此扩展程序可按类别对内容进行分类，还可分析内容的情感基调（从积极到消极）。

此内容提供了有关配置和使用此扩展程序的参考信息。如需了解如何使用 Apigee 控制台配置扩展程序，请参阅添加和配置扩展程序。

操作

classifyContent

分析部分文本并返回适用于该文本的内容分类列表。

如需详细了解 Natural Language API 中的此功能，请参阅对内容进行分类和内容类别。

请求参数

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
参数 说明 类型 默认值 必填
数据 要分析的内容。 字符串 无。 是。

响应

一个 Categories 数组，其中每个项都包含用于对内容进行分类的类别和置信度得分。

sentenceSentiment

分析给定文本，并确定其中的主导性情绪观点，尤其是确定作者的态度是积极、消极还是中立的。

如需详细了解 Natural Language API 中的此功能，请参阅分析情感和 Natural Language API 基础知识。

请求参数

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
参数 说明 类型 默认值 必填
数据 要分析的内容。 字符串 无。 是。

响应

一个对象，包含文档的总体情感得分以及每个句子的情感得分（以数组形式呈现）。对于文档及其句子，系统会提供以下属性：

  • 包含已分析内容的 Content 属性。
  • 一个 Score 属性，用于指示内容的情感，范围介于 1 和 -1 之间，从积极（正数）到消极（负数）。
  • 一个 Magnitude 属性，用于表示内容中情绪（包括积极和消极）的整体强度，介于 0.0 和 +inf 之间。

entitySentiment

分析指定文本，以确定文本中针对每个实体表达的情感（正面还是负面）。实体情感用数字分数和量值来表示，并且为实体的每次提及进行确定。这些分数随后会汇总为实体的总体情感分数和量级。

如需详细了解 Google Cloud Natural Language API 中的实体分析，请参阅分析实体情感和解读情感分析值。

请求参数

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
参数 说明 类型 默认值 必填
数据 要分析的内容。 字符串 无。 是。

响应

一个对象数组，包含文本中实体的情感得分。对于文档及其句子，系统会提供以下属性：

  • 具有 . 的 Name 属性。
  • 一个描述实体类型的 Type 属性。
  • 一个 Score 属性，用于指示实体的 sentiment，范围介于 1 和 -1 之间，从正（正数）到负（负数）。
  • 一个 Magnitude 属性，用于指示实体的情感强度（包括积极和消极），介于 0.0 和 +inf 之间。

配置参考文档

在配置和部署此扩展以在 API 代理中使用时，请使用以下内容。

常见扩展属性

每个扩展程序都有以下属性。

属性 说明 默认 必需
name 您为扩展程序配置此名称。 无 是
packageName Apigee Edge 提供的扩展包的名称。 无 是
version 配置扩展程序所用的扩展程序软件包的版本号。 无 是
configuration 特定于您要添加的附加信息的配置值。请参阅此扩展程序软件包的属性 无 是

相应扩展程序包的属性

为此扩展程序特有的以下配置属性指定值。

属性 说明 默认 必填
凭证 在 Apigee Edge 控制台中输入时，这是服务账号密钥文件的内容。通过管理 API 发送时，它是根据服务账号密钥文件生成的 base64 编码值。 无。 是。