L'analyse des sentiments d'entités combine l'analyse des entités et l'analyse des sentiments pour tenter de déterminer le sentiment (positif ou négatif) exprimé à propos des entités d'un texte.
Le sentiment de l'entité est représenté par un score numérique et des valeurs de magnitude, et il est déterminé pour chaque mention d'une entité. Ces scores sont ensuite agrégés pour former un score et une magnitude de sentiment globaux pour une entité.
Pour plus d'informations sur l'interprétation des valeurs de sentiment score
et magnitude
incluses dans l'analyse, consultez la section Interpréter les valeurs d'analyse des sentiments.
Les exemples suivants montrent comment interroger la méthode analyzeEntitySentiment
.
Vous devez envoyer une demande distincte pour chaque document.
Analyser les sentiments d'entités
Voici un exemple d'analyse des sentiments d'entités sous forme de chaîne :
Protocole
Pour analyser les sentiments d'entités dans un document, envoyez une requête POST
à la méthode REST documents:analyzeEntitySentiment
et fournissez le corps de requête approprié comme illustré 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':'I love R&B music. Marvin Gaye is the best. \'What\'s Going On\' is one of my favorite songs. It was so sad when Marvin Gaye died.' }, 'encodingType':'UTF8' }" "https://language.googleapis.com/v1/documents:analyzeEntitySentiment"
gcloud
Reportez-vous à la commande analyze-entity-sentiment
pour obtenir tous les détails.
Pour effectuer une analyse des sentiments d'entités, utilisez gcloud CLI et utilisez l'option --content
pour identifier le contenu à analyser :
gcloud ml language analyze-entity-sentiment \ --content="I love R&B music. Marvin Gaye is the best. 'What's Going On' is one of my favorite songs. It was so sad when Marvin Gaye died."
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.
Analyser les sentiments d'entités depuis Cloud Storage
Voici un exemple d'analyse des sentiments d'entités dans un fichier texte stocké sur Cloud Storage :
Protocole
Pour analyser les sentiments d'entités dans un document stocké dans Cloud Storage, envoyez une requête POST
à la méthode REST documents:analyzeEntitySentiment
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>' } }" "https://language.googleapis.com/v1/documents:analyzeEntitySentiment"
gcloud
Reportez-vous à la commande analyze-entity-sentiment
pour obtenir tous les détails.
Pour effectuer une analyse des sentiments d'entités, utilisez gcloud CLI et utilisez l'option --content
pour identifier le contenu à analyser :
gcloud ml language analyze-entity-sentiment \ --content-file=gs://<bucket-name>/<object-name>
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.