Method: documents.annotateText

Un metodo pratico che fornisce tutte le funzionalità di sintassi, sentiment, entità e classificazione in un'unica chiamata.

Richiesta HTTP

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

L'URL utilizza la sintassi di transcodifica gRPC.

Corpo della richiesta

Il corpo della richiesta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "document": {
    object (Document)
  },
  "features": {
    object (Features)
  },
  "encodingType": enum (EncodingType)
}
Campi
document

object (Document)

Obbligatorio. Inserisci il documento.
features

object (Features)

Obbligatorio. Le funzionalità abilitate.
encodingType

enum (EncodingType)

Il tipo di codifica utilizzato dall'API per calcolare gli offset.

Corpo della risposta

Il messaggio di risposta per le annotazioni di testo.

In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:

Rappresentazione JSON 
{
  "sentences": [
    {
      object (Sentence)
    }
  ],
  "tokens": [
    {
      object (Token)
    }
  ],
  "entities": [
    {
      object (Entity)
    }
  ],
  "documentSentiment": {
    object (Sentiment)
  },
  "language": string,
  "categories": [
    {
      object (ClassificationCategory)
    }
  ],
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ]
}
Campi
sentences[]

object (Sentence)

Frasi nel documento di input. Viene compilato se l'utente attiva AnnotateTextRequest.Features.extract_syntax.
tokens[]

object (Token)

Token, insieme alle relative informazioni sintattiche, nel documento di input. Viene compilato se l'utente attiva AnnotateTextRequest.Features.extract_syntax.
entities[]

object (Entity)

Entità, insieme alle relative informazioni semantiche, nel documento di input. Viene compilato se l'utente attiva AnnotateTextRequest.Features.extract_entities.
documentSentiment

object (Sentiment)

Il sentiment complessivo del documento. Viene compilato se l'utente attiva AnnotateTextRequest.Features.extract_document_sentiment.
language

string

La lingua del testo, che corrisponderà alla lingua specificata nella richiesta o, se non specificata, alla lingua rilevata automaticamente. Per ulteriori dettagli, consulta il campo Document.language.
categories[]

object (ClassificationCategory)

Categorie identificate nel documento di input.
moderationCategories[]

object (ClassificationCategory)

Categorie dannose e sensibili identificate nel documento di input.

Ambiti di autorizzazione

Richiede uno dei seguenti ambiti OAuth:

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

Per ulteriori informazioni, consulta la Panoramica dell'autenticazione.

Funzionalità

Tutte le funzionalità disponibili per l'analisi del sentiment, della sintassi e della semantica. Se imposti ciascuna su true, verrà attivata l'analisi specifica per l'input.

Rappresentazione JSON 
{
  "extractSyntax": boolean,
  "extractEntities": boolean,
  "extractDocumentSentiment": boolean,
  "extractEntitySentiment": boolean,
  "classifyText": boolean,
  "moderateText": boolean,
  "classificationModelOptions": {
    object (ClassificationModelOptions)
  }
}
Campi
extractSyntax

boolean

Estrai informazioni sulla sintassi.
extractEntities

boolean

Estrarre le entità.
extractDocumentSentiment

boolean

Estrai il sentiment a livello di documento.
extractEntitySentiment

boolean

Estrai le entità e il relativo sentiment.
classifyText

boolean

Classifica l'intero documento in categorie. In questo caso, l'API utilizzerà il modello predefinito che classifica in una tassonomia predefinita.
moderateText

boolean

Modera il documento per individuare contenuti dannosi e sensibili.
classificationModelOptions

object (ClassificationModelOptions)

Facoltativo. Le opzioni del modello da utilizzare per la classificazione. Se non specificato, vengono utilizzate le opzioni della versione 1. Viene utilizzato solo se classifyText è impostato su true.