Google Cloud Natural Language 扩展程序

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

版本 2.0.0

提供对 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 属性。
  • 得分属性,表示内容的情感,介于 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 控制台中输入此值时,系统会将其视为服务账号密钥文件的内容。通过 Management API 发送时,此参数是从服务账号密钥文件生成的 base64 编码值。 无。 是。