Method: documents.moderateText

Modera un documento per categorie dannose e sensibili.

Richiesta HTTP

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

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)
  },
  "modelVersion": enum (ModelVersion)
}
Campi
document

object (Document)

Obbligatorio. Inserisci il documento.
modelVersion

enum (ModelVersion)

Facoltativo. La versione del modello da utilizzare per documents.moderateText.

Corpo della risposta

Il messaggio di risposta alla moderazione del documento.

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

Rappresentazione JSON 
{
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ],
  "languageCode": string,
  "languageSupported": boolean
}
Campi
moderationCategories[]

object (ClassificationCategory)

Categorie dannose e sensibili che rappresentano il documento di input.
languageCode

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][].
languageSupported

boolean

Se la lingua è ufficialmente supportata. L'API potrebbe comunque restituire una risposta quando la lingua non è supportata, ma si tratta di un servizio secondo il criterio del "best effort".

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.

ModelVersion

La versione del modello da utilizzare per documents.moderateText.

Enum
MODEL_VERSION_UNSPECIFIED La versione del modello predefinita.
MODEL_VERSION_1 Utilizza il modello v1, che viene utilizzato per impostazione predefinita se non viene fornito. Il modello v1 restituisce solo il punteggio di probabilità (affidabilità) per ogni categoria.
MODEL_VERSION_2 Utilizza il modello v2. Il modello v2 restituisce solo il punteggio di probabilità (affidabilità) per ogni categoria e il punteggio di gravità per un sottoinsieme di categorie.