Method: documents.classifyText

HTTP request
Request body
- JSON representation
Response body
- JSON representation
Authorization scopes
Try it!

Classifies a document into categories.

HTTP request

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

Request body

The request body contains data with the following structure:

JSON representation
{ "document" : { object ( `Document` ) } }

Fields

Fields
`document`	`object ( Document )` Required. Input document.

document

object ( Document )

Required. Input document.

Response body

The document classification response message.

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

JSON representation
{ "categories" : [ { object ( `ClassificationCategory` ) } ] , "languageCode" : string , "languageSupported" : boolean }

Fields

Fields
`categories[]`	`object ( ClassificationCategory )` Categories representing the input document.
`language Code`	`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.
`language Supported`	`boolean` Whether the language is officially supported. The API may still return a response when the language is not supported, but it is on a best effort basis.

categories[]

object ( ClassificationCategory )

Categories representing the input document.

language  
Code

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.

language  
Supported

boolean

Whether the language is officially supported. The API may still return a response when the language is not supported, but it is on a best effort basis.

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 .