Google Cloud Natural Language 扩展程序

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

版本 2.0.2

提供对 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 属性，用于指示实体的情感，范围介于 1 和 -1 之间，从正面（正数）到负面（负数）。
• 一个 Magnitude 属性，用于指示实体的感情强度（包括正面和负面），介于 0.0 和 +inf 之间。

配置参考文档

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

常见扩展属性

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

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

相应扩展程序包的属性

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

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