Method: documents.moderateText

Modère un document pour les catégories nuisibles et sensibles.

Requête HTTP

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

L'URL utilise la syntaxe de transcodage gRPC.

Corps de la requête

Le corps de la requête contient des données présentant la structure suivante :

Représentation JSON 
{
  "document": {
    object (Document)
  },
  "modelVersion": enum (ModelVersion)
}
Champs
document

object (Document)

Obligatoire. Document d'entrée.
modelVersion

enum (ModelVersion)

Facultatif. Version du modèle à utiliser pour documents.moderateText.

Corps de la réponse

Message de réponse de la modération des documents.

Si la requête aboutit, le corps de la réponse contient des données qui ont la structure suivante :

Représentation JSON 
{
  "moderationCategories": [
    {
      object (ClassificationCategory)
    }
  ],
  "languageCode": string,
  "languageSupported": boolean
}
Champs
moderationCategories[]

object (ClassificationCategory)

Catégories nuisibles et sensibles représentant le document d'entrée.
languageCode

string

Langue du texte, qui correspond à celle spécifiée dans la requête ou, si celle-ci est omise, à la langue détectée automatiquement. Pour en savoir plus, consultez le champ [Document.language][].
languageSupported

boolean

Indique si la langue est officiellement prise en charge. L'API peut toujours renvoyer une réponse lorsque la langue n'est pas prise en charge, mais dans la mesure du possible.

Champs d'application des autorisations

Nécessite l'un des champs d'application OAuth suivants :

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

Pour en savoir plus, consultez la page Présentation de l'authentification.

ModelVersion

Version du modèle à utiliser pour documents.moderateText.

Enums
MODEL_VERSION_UNSPECIFIED Version par défaut du modèle.
MODEL_VERSION_1 Utilisez le modèle v1, qui est utilisé par défaut lorsqu'il n'est pas fourni. Le modèle v1 ne renvoie qu'un score de probabilité (confiance) pour chaque catégorie.
MODEL_VERSION_2 Utilisez le modèle v2. Le modèle v2 ne renvoie qu'un score de probabilité (confiance) pour chaque catégorie et un score de gravité pour un sous-ensemble de catégories.