La classification de contenu analyse un document et renvoie une liste de catégories de contenu qui s'appliquent au texte présent dans le document. Pour classifier le contenu dans un document, appelez la méthode classifyText
.
La liste complète des catégories de contenu renvoyées pour la méthode classifyText
figure ici.
Vous pouvez choisir le modèle à utiliser
classifyText
en définissant l'option
classificationModelOptions
:
V2 model
est un modèle plus récent offrant de meilleures performances, compatible Catégories de contenu de la version 1 et les catégories de contenu de la version 2.V1 model
accepte uniquement les catégories de contenu de la version 1.
Vous trouverez dans cette section la procédure à suivre pour classifier le contenu d'un document. Vous devez envoyer une demande distincte pour chaque document.
Classifier du contenu
Voici un exemple de classification de contenu fourni sous forme de chaîne :
Protocole
Pour classifier le contenu d'un document, envoyez une requête POST
à la méthode REST documents:classifyText
et fournissez le corps de requête approprié, comme indiqué dans l'exemple suivant.
L'exemple utilise la commande gcloud auth application-default print-access-token
pour obtenir un jeton d'accès pour un compte de service configuré pour le projet à l'aide de gcloud CLI de Google Cloud Platform.
Pour obtenir des instructions d'installation de la gcloud CLI et configurer un projet avec un compte de service, consultez le guide de démarrage rapide.
curl -X POST \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'document':{ 'type':'PLAIN_TEXT', 'content':'Google, headquartered in Mountain View, unveiled the new Android phone at the Consumer Electronic Show. Sundar Pichai said in his keynote that users love their new Android phones.' }, 'classificationModelOptions': { 'v2Model': { 'contentCategoriesVersion': 'V2', } } }" "https://language.googleapis.com/v1/documents:classifyText"
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Go Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Java Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Node.js Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Python Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langues supplémentaires
C#: Veuillez suivre les Instructions de configuration de C# sur la page des bibliothèques clientes puis accédez à la page Documentation de référence Natural Language pour .NET
PHP: Veuillez suivre les Instructions de configuration de PHP sur la page des bibliothèques clientes puis accédez à la page Documentation de référence sur Natural Language pour PHP
Ruby: Veuillez suivre les Instructions de configuration de Ruby sur la page des bibliothèques clientes puis accédez à la page Documentation de référence sur Natural Language pour Ruby.
Classifier du contenu provenant de Cloud Storage
Voici un exemple de classification de contenu stocké dans un fichier texte sur Cloud Storage :
Protocole
Pour classifier le contenu d'un document stocké dans Cloud Storage, envoyez une requête POST
à la méthode REST documents:classifyText
et fournissez un corps de requête approprié avec le chemin d'accès au document comme illustré dans l'exemple suivant.
curl -X POST \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'document':{ 'type':'PLAIN_TEXT', 'gcsContentUri':'gs://<bucket-name>/<object-name>' } 'classificationModelOptions': { 'v1Model': { } } }" "https://language.googleapis.com/v1/documents:classifyText"
Go
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Go Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Java
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Java Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Node.js
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Node.js Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Python
Pour savoir comment installer et utiliser la bibliothèque cliente pour Natural Language, consultez Bibliothèques clientes Natural Language. Pour en savoir plus, consultez les API Python Natural Language documentation de référence.
Pour vous authentifier auprès de Natural Language, configurez les identifiants par défaut de l'application. Pour en savoir plus, consultez Configurer l'authentification pour un environnement de développement local.
Langues supplémentaires
C#: Veuillez suivre les Instructions de configuration de C# sur la page des bibliothèques clientes puis accédez à la page Documentation de référence Natural Language pour .NET
PHP: Veuillez suivre les Instructions de configuration de PHP sur la page des bibliothèques clientes puis accédez à la page Documentation de référence sur Natural Language pour PHP
Ruby: Veuillez suivre les Instructions de configuration de Ruby sur la page des bibliothèques clientes puis accédez à la page Documentation de référence sur Natural Language pour Ruby.