Method: documents.analyzeSentiment

Analyzes the sentiment of the provided text.

HTTP request

POST https://language.googleapis.com/v1/documents:analyzeSentiment

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "document": {
    object (Document)
  },
  "encodingType": enum (EncodingType)
}
Fields
document

object (Document)

Required. Input document.

encodingType

enum (EncodingType)

The encoding type used by the API to calculate sentence offsets.

Response body

The sentiment analysis response message.

If successful, the response body contains data with the following structure:

JSON representation
{
  "documentSentiment": {
    object (Sentiment)
  },
  "language": string,
  "sentences": [
    {
      object (Sentence)
    }
  ]
}
Fields
documentSentiment

object (Sentiment)

The overall sentiment of the input document.

language

string

The language of the text, which will be the same as the language specified in the request or, if not specified, the automatically-detected language. See Document.language field for more details.

sentences[]

object (Sentence)

The sentiment for all the sentences in the document.

Authorization scopes

Requires one of the following OAuth scopes:

  • https://www.googleapis.com/auth/cloud-language
  • https://www.googleapis.com/auth/cloud-platform

For more information, see the Authentication Overview.