Method: documents.annotateText

Um método de conveniência que fornece todos os recursos de analyzeSentiment, analyzeEntities e analyzeSyntax em uma chamada.

Solicitação HTTP

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

O URL usa a sintaxe de transcodificação gRPC.

Corpo da solicitação

O corpo da solicitação contém dados com a seguinte estrutura:

Representação JSON 
{
  "document": {
    object (Document)
  },
  "features": {
    object (Features)
  },
  "encodingType": enum (EncodingType)
}
Campos
document

object (Document)

Obrigatório. Documento de entrada.
features

object (Features)

Obrigatório. Os recursos ativados.
encodingType

enum (EncodingType)

O tipo de codificação usado pela API para calcular os deslocamentos.

Corpo da resposta

A mensagem de resposta de anotações de texto.

Se bem-sucedido, o corpo da resposta incluirá dados com a estrutura a seguir:

Representação JSON 
{
  "sentences": [
    {
      object (Sentence)
    }
  ],
  "tokens": [
    {
      object (Token)
    }
  ],
  "entities": [
    {
      object (Entity)
    }
  ],
  "documentSentiment": {
    object (Sentiment)
  },
  "language": string,
  "categories": [
    {
      object (ClassificationCategory)
    }
  ],
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ]
}
Campos
sentences[]

object (Sentence)

Frases no documento de entrada. Preenchido se o usuário ativar AnnotateTextRequest.Features.extract_syntax.
tokens[]

object (Token)

Tokens e suas informações sintáticas no documento de entrada. Preenchido se o usuário ativar AnnotateTextRequest.Features.extract_syntax.
entities[]

object (Entity)

Entidades e suas informações semânticas no documento de entrada. Preenchido se o usuário ativar AnnotateTextRequest.Features.extract_entities.
documentSentiment

object (Sentiment)

O sentimento geral do documento. Preenchido se o usuário ativar AnnotateTextRequest.Features.extract_document_sentiment.
language

string

O idioma do texto, que será o mesmo especificado na solicitação ou, se não especificado, detectado automaticamente. Consulte o campo Document.language para mais detalhes.
categories[]

object (ClassificationCategory)

Categorias identificadas no documento de entrada.
moderationCategories[]

object (ClassificationCategory)

Categorias nocivas e sensíveis identificadas no documento de entrada.

Escopos de autorização

Requer um dos seguintes escopos de OAuth:

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

Para saber mais, consulte a Visão geral da autenticação.

Recursos

Todos os recursos disponíveis de análise sintática, semântica e de sentimento. Defina cada um como verdadeiro para permitir a análise específica da entrada.

Representação JSON 
{
  "extractSyntax": boolean,
  "extractEntities": boolean,
  "extractDocumentSentiment": boolean,
  "extractEntitySentiment": boolean,
  "classifyText": boolean,
  "moderateText": boolean,
  "classificationModelOptions": {
    object (ClassificationModelOptions)
  }
}
Campos
extractSyntax

boolean

Extrair informações de sintaxe.
extractEntities

boolean

Extrair entidades.
extractDocumentSentiment

boolean

Extrair o sentimento no nível do documento.
extractEntitySentiment

boolean

Extrair entidades e os sentimentos associados.
classifyText

boolean

Classificar o documento completo em categorias.
moderateText

boolean

Moderar o documento para categorias nocivas e sensíveis.
classificationModelOptions

object (ClassificationModelOptions)

Opcional. As opções de modelo a serem usadas para a classificação. Se não for especificado, o padrão será as opções da v1. Só será usado se classifyText estiver definido como verdadeiro.