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 的等級,從正數 (正數) 到負 (負數)。
  • 表示內容整體情緒強度 (包括正面和負面) 的 Magnitude 屬性,介於 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 編碼值。 無。 是。