Method: documents.classifyText

Classifies a document into categories.

HTTP request

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

The URL uses gRPC Transcoding syntax.

Request body

The request body contains data with the following structure:

JSON representation
{
  "document": {
    object (Document)
  },
  "classificationModelOptions": {
    object (ClassificationModelOptions)
  }
}
Fields
document

object (Document)

Required. Input document.

classificationModelOptions

object (ClassificationModelOptions)

Optional. Model options to use for classification. Defaults to v1 options if not specified.

Response body

The document classification response message.

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

JSON representation
{
  "categories": [
    {
      object (ClassificationCategory)
    }
  ]
}
Fields
categories[]

object (ClassificationCategory)

Categories representing the input 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.