Расширение Google Cloud Natural Language

Вы просматриваете документацию по Apigee Edge.
Перейдите к документации по Apigee X.
Информация

Версия 2.0.1

Предоставляет доступ к 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>
Параметр Описание Тип По умолчанию Обязательно
делал. Контент для анализа. Строка Нет. Да.

Ответ

Объект, содержащий оценки тональности для документа в целом и для каждого предложения (в массиве). Для документа и его предложений указываются следующие свойства:

  • Свойство контента с проанализированным контентом.
  • Свойство Score, указывающее отношение к контенту по шкале от 1 до -1, где положительное число означает положительное отношение, а отрицательное – отрицательное.
  • Свойство "Сила эмоций", указывающее общую силу эмоций (как положительных, так и отрицательных) в контенте.Значение может быть от 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, сгенерированное из файла ключа сервисного аккаунта. Нет. Да.