Google Cloud Natural Language 擴充功能

您正在查看 Apigee Edge 說明文件。
查看 Apigee X 說明文件。 資訊

1.4.1 版

提供 Google Cloud Natural Language API 的存取權。

你可以使用這項擴充功能將內容分類，也可以分析正面到負向中的情緒情緒。

本文提供設定和使用這個擴充功能的參考資料。如需使用 Apigee 控制台設定擴充功能的相關步驟，請參閱「新增及設定擴充功能」。

動作

classifyContent

分析部分文字，並傳回適用於該文字的內容類別清單。

如要進一步瞭解 Natural Language API 中的這項功能，請參閱分類內容和內容類別。

要求參數

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>

參數	說明	類型	預設	需要
資料或曾存取這類資料的人員	要分析的內容。	字串	無。	可以。

回應

類別陣列，其中每個項目都包含用來分類內容的類別和可信度分數。

sentenceSentiment

分析指定的內容，識別其中的主要情緒觀點，尤其是判斷撰寫者的態度為正面、負面或中立。

如要進一步瞭解 Natural Language API 的這項功能，請參閱分析情緒和 Natural Language API 基本概念。

要求參數

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>

參數	說明	類型	預設	需要
資料或曾存取這類資料的人員	要分析的內容。	字串	無。	可以。

回應

包含文件整體及其每個句子 (在陣列中) 情緒分數的物件。文件及其語句皆包含下列屬性：

• 具有分析內容的內容屬性。
• 表示內容情緒以 1 到 1 之間的量表，從正數 (正數) 到負數 (負數)。
• 規模屬性表示內容的整體情緒強度 (包括正面和負面)，介於 0.0 和 +inf 之間。

entitySentiment

分析指定文字，判斷文字內容中各實體表達的情緒 (正面或負面)。實體情緒會以數值分數和規模值表示，並依據每次提及實體的情況進行判定。這些分數會匯總為實體的整體情緒分數與規模。

如要進一步瞭解 Google Cloud Natural Language API 中的實體分析，請參閱分析實體情緒和情緒分析值說明。

要求參數

<Input><![CDATA[{
  "data" : "content-to-analyze"
}]]></Input>

參數	說明	類型	預設	需要
資料或曾存取這類資料的人員	要分析的內容。	字串	無。	可以。

回應

含有文字中實體情緒分數的物件陣列。文件及其語句皆包含下列屬性：

• 附有 的名稱屬性。
• 說明實體類型的 Type 屬性。
• 分數屬性，以 1 到 1 之間的尺度表示實體的情緒，範圍從正數 (正數) 到負數 (負數)。
• Magnitude 屬性代表實體的情緒強度 (包括正面和負面)，介於 0.0 和 +inf 之間。

設定參考資料

如果您要設定及部署這個擴充功能，以便用於 API Proxy，請按照下列指示操作。

常見擴充功能屬性

每個擴充功能都有下列屬性。

屬性	說明	預設	必要
name	您要為這項擴充功能設定的名稱。	無	相容
packageName	Apigee Edge 指定的擴充功能套件名稱。	無	相容
version	擴充功能的擴充功能套件版本號碼。	無	相容
configuration	您要新增的擴充功能專屬的設定值。請參閱「這個擴充功能套件的屬性」一文	無	相容

這個擴充功能套件的屬性

指定這個擴充功能的下列設定屬性值。

屬性	說明	預設	需要
憑證	在 Apigee Edge 控制台中輸入時，服務帳戶金鑰檔案的內容即為。透過 Management API 傳送時，是由服務帳戶金鑰檔案產生的 Base64 編碼值。	無。	可以。