Google Cloud Natural Language 擴充功能

您目前查看的是 Apigee Edge 說明文件。
前往 Apigee X 說明文件。 info

2.0.2 版

提供 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 屬性。
• 描述實體類型的「類型」屬性。
• 「分數」屬性：指出實體的情緒，範圍介於 1 和 -1 之間，從正面 (正數) 到負面 (負數)。
• Magnitude 屬性，表示實體的情緒強度 (包括正面和負面)，介於 0.0 和 +inf 之間。

設定參考資料

設定及部署這個擴充功能，以便在 API Proxy 中使用時，請按照下列步驟操作。

常見的擴充功能屬性

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

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

這個擴充套件的屬性

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

屬性	說明	預設	必填
憑證	在 Apigee Edge 控制台中輸入時，這是服務帳戶金鑰檔案的內容。透過 Management API 傳送時，這是從服務帳戶金鑰檔案產生的 base64 編碼值。	無。	是。