Rozszerzenie Google Cloud Natural Language

Przeglądasz dokumentację Apigee Edge.
Przejdź do Dokumentacja Apigee X. informacje.

Wersja 1.2.0

Zapewnia dostęp do interfejsu Google Cloud Natural Language API.

To rozszerzenie pozwala klasyfikować treści według kategorii, a także analizować nastroje dotyczące treści w skali dodatniej i ujemnej.

W tym artykule znajdziesz informacje na temat konfigurowania i używania tego rozszerzenia. Instrukcje konfigurowania rozszerzenia za pomocą konsoli Apigee znajdziesz w artykule Dodawanie i konfigurowanie rozszerzenia.

Działania

classifyContent

Analizuje fragment tekstu i zwraca listę kategorii treści, które mają zastosowanie do tego tekstu.

Więcej informacji o tej funkcji interfejsu Natural Language API znajdziesz w artykułach Klasyfikowanie treści i Kategorie treści.

Parametry żądania

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametr Opis Typ Domyślny Wymagane
dane Treść do przeanalizowania. Ciąg znaków Brak. Tak.

Odpowiedź

Tablica Kategorie, w której każdy element zawiera kategorię do klasyfikowania treści oraz wskaźnik ufności.

sentenceSentiment

Analizuje dany tekst i określa dominującą w nim opinię emocjonalną, zwłaszcza po to, aby określić nastawienie pisarza jako pozytywne, negatywne lub neutralne.

Więcej informacji o tej funkcji interfejsu Natural Language API znajdziesz w artykułach Analyzing Sentiment (Analiza nastawienia) i Natural Language API – podstawy.

Parametry żądania

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametr Opis Typ Domyślny Wymagane
dane Treść do przeanalizowania. Ciąg znaków Brak. Tak.

Odpowiedź

Obiekt zawierający wyniki nastawienia dla całego dokumentu i wszystkich jego zdań (w tablicy). Zarówno dokument, jak i zdania zawierają te właściwości:

  • Właściwość treści z analizowaną treścią.
  • Właściwość wyniku określająca nastawienie do treści w skali od 1 do -1, od dodatniej (liczby dodatniej) do ujemnej (liczby ujemnej).
  • Właściwość Magnitude wskazująca ogólną siłę emocji (zarówno pozytywnych, jak i negatywnych) w treści w zakresie od 0,0 do +inf.

entitySentiment

Analizuje określony tekst, aby określić opinię (pozytywną lub negatywną) związaną z każdym podmiotem w tekście. Nastawienie do elementu jest określone za pomocą wyniku liczbowego i wartości wielkości oraz jest określane w przypadku każdej wzmianki o podmiocie. Wyniki te są następnie agregowane w ogólny wynik nastawienia i skalę dla danego elementu.

Więcej informacji o analizie encji w interfejsie Google Cloud Natural Language API znajdziesz w artykułach Analiza nastawienia encji i Interpretowanie wartości analizy nastawienia.

Parametry żądania

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>
Parametr Opis Typ Domyślny Wymagane
dane Treść do przeanalizowania. Ciąg znaków Brak. Tak.

Odpowiedź

Tablica obiektów z wynikami nastawienia dla elementów w tekście. Zarówno dokument, jak i zdania zawierają te właściwości:

  • Właściwość Nazwa z
  • Właściwość Typ opisująca typ elementu.
  • Właściwość wyniku określająca nastawienie do elementu na skali od 1 do -1, od dodatniej (liczby dodatniej) do ujemnej (liczby ujemnej).
  • Właściwość Magnitude wskazująca siłę emocji (pozytywną i negatywną) związaną z danym elementem w zakresie od 0, 0 do +inf.

Odniesienie do konfiguracji

Podczas konfigurowania i wdrażania tego rozszerzenia na potrzeby serwerów proxy interfejsu API użyj poniższych wskazówek.

Typowe właściwości rozszerzeń

Dla każdego rozszerzenia dostępne są poniższe właściwości.

Usługa Opis Domyślnie Wymagany
name Nazwa nadana konfiguracji rozszerzenia. Brak Tak
packageName Nazwa pakietu rozszerzeń podana przez Apigee Edge. Brak Tak
version Numer wersji pakietu rozszerzenia, z którego konfigurujesz rozszerzenie. Brak Tak
configuration Wartość konfiguracji specyficzna dla dodawanego rozszerzenia. Zobacz Właściwości tego pakietu rozszerzeń Brak Tak

Właściwości tego pakietu rozszerzeń

Określ wartości następujących właściwości konfiguracji specyficznych dla tego rozszerzenia.

Właściwość Opis Domyślny Wymagane
dane logowania Jeśli wpiszesz ją w konsoli Apigee Edge, zobaczysz zawartość pliku klucza konta usługi. W przypadku wysyłania przez interfejs API zarządzania jest to wartość zakodowana w formacie base64 generowana na podstawie pliku klucza konta usługi. Brak. Tak.