Google Cloud Natural Language 擴充功能

您正在查看 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

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>

參數	說明	類型	預設	必填
資料	要分析的內容。	字串	無。	是。

回應

物件，其中包含文件整體和每個句子的情緒分數 (以陣列表示)。文件和句子都包含下列屬性：

• 含有已分析內容的內容資源。
• 分數屬性：用於指出內容的情緒，範圍介於 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 編碼值。	無。	是。