---
title: "感情分析"
url: https://docs.catalyst.zoho.com/ja/api/code-reference/zia-services/text-analytics/sentiment-analysis/
description: "このAPIを使用すると、テキストブロックに対してSentiment Analysisを実行し、メッセージのトーンとテキスト内のセンチメントを認識できます。"
last_updated: 2026-03-30T08:10:30Z
service: Zia Services
type: api
---

# Sentiment Analysis

[Zia Sentiment Analysis](https://docs.catalyst.zoho.com/ja/zia-services/help/text-analytics/introduction/)は、Text Analyticsの一部で、テキストコンテンツを処理してメッセージのトーンと、それを通じて伝えられるセンチメントを認識します。テキスト内の各文を分析して、そのトーンがPositive、Negative、またはNeutralであるかを判定します。次に、各文で認識されたセンチメントに基づいて、テキスト全体のトーンをこれら3つのセンチメントのいずれかとして判定します。

レスポンスには、分析の精度を示すために、各文とテキスト全体の信頼度スコアも返されます。

# Sentiment Analysisの実行

### 説明

このAPIを使用して、1回のリクエストで最大1500文字のテキストブロックに対してSentiment Analysisを実行できます。サンプルリクエストに示すように、リクエストのJSONボディにテキストを渡す必要があります。

また、テキストに対してオプションのキーワードを渡すこともできます。これにより、Sentiment Analysisはこれらのキーワードを含む文のみを処理し、そのセンチメントを判定します。他の文は無視されます。

### リクエスト詳細

#### リクエストURL

`POST` {api-domain}/baas/v1/project/{project_id}/ml/text-analytics/sentiment-analysis

- **api-domain** (URL): Catalyst APIにアクセスするためのDC固有のドメイン

- **project_id** (Numerical): プロジェクトの[一意のID](https://docs.catalyst.zoho.com/ja/getting-started/set-up-a-catalyst-project/general-settings/)

#### リクエストヘッダー
 **Authorization:** Zoho-oauthtoken {oauth_token} 

**content-type:** application/json

**オプションヘッダー** 

 **CATALYST-ORG:** {org_id}

 **Environment:** Development

#### スコープ

ZohoCatalyst.mlkit.READ

#### リクエストJSONプロパティ

- **document** (string array, mandatory):  Sentiment Analysisのために処理するテキスト

- **keywords** (string array, optional):  これらのキーワードを含む文に対してのみSentiment Analysisを実行するため

### レスポンス詳細

レスポンスには、個々の文の分析結果とテキスト全体の分析結果が、`Positive`、`Negative`、または`Neutral`として含まれ、各分析の全体的な信頼度スコアも含まれます。信頼度スコアは0から1の範囲です。

**リクエスト例**

```bash
curl -X POST \
https://api.catalyst.zoho.com/baas/v1/project/4000000006007/ml/text-analytics/sentiment-analysis 
-H "Authorization: Zoho-oauthtoken 1000.910*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*16.2f*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*\*57" \
-H "Content-Type: application/json" \
-d '{"document":"[I love the design of the new model.]",
"keywords":"[design]"
}'

```

**レスポンス例**

```json

      {
      "status":"success",
      "data":[
      {
      "sentiment_prediction":[
      {
      "document_sentiment":"Positive",
      "sentence_analytics":[
      {
      "sentence":"I love the design of the new model",
      "sentiment":"Positive",
      "confidence_scores":{
      "negative":0.0,
      "neutral":0.0,
      "positive":1.0
      }
      }
      ],
      "keyword":"design",
      "overall_score":1.0
      }
      ]
      }
      ]
      }
```

### SDK Documentation

[Text Analytics: Sentiment Analysis- Java SDK](https://docs.catalyst.zoho.com/ja/sdk/java/v1/zia-services/text-analytics/sentiment-analysis)

[Text Analytics: Sentiment Analysis- Node.js SDK](https://docs.catalyst.zoho.com/ja/sdk/nodejs/v2/zia-services/text-analytics/sentiment-analysis)

[Text Analytics: Sentiment Analysis- Python SDK](https://docs.catalyst.zoho.com/ja/sdk/python/v1/zia-services/text-analytics/sentiment-analysis)