L'analisi del sentiment esamina il testo specificato e identifica la variante prevalente
l'opinione emotiva all'interno del testo, soprattutto per determinare l'atteggiamento di chi scrive
positiva, negativa o neutra. L'analisi del sentiment viene eseguita mediante il metodo
analyzeSentiment
. Per informazioni sulle lingue supportate dall'API Natural Language,
consulta la sezione Supporto lingue. Per informazioni su
come interpretare i valori di sentiment score
e magnitude
inclusi in
consulta la pagina Interpretazione dei valori dell'analisi del sentiment.
Questa sezione illustra alcuni modi per rilevare il sentiment in un documento. Devi inviare una richiesta separata per ciascun documento.
Analisi del sentiment in una stringa
Ecco un esempio di analisi del sentiment su una stringa di testo inviata direttamente all'API Natural Language:
Protocollo
Per analizzare il sentiment in un documento, invia una richiesta POST
al metodo REST
documents:analyzeSentiment
e fornisci il corpo della richiesta appropriato, come mostrato nell'esempio seguente.
L'esempio utilizza il comando gcloud auth application-default print-access-token
per ottenere un token di accesso per un account di servizio configurato per il
progetto utilizzando gcloud CLI della piattaforma Google Cloud.
Per istruzioni sull'installazione di gcloud CLI,
configura un progetto con un account di servizio
consulta la Guida rapida.
curl -X POST \ -H "Authorization: Bearer "$(gcloud auth application-default print-access-token) \ -H "Content-Type: application/json; charset=utf-8" \ --data "{ 'encodingType': 'UTF8', 'document': { 'type': 'PLAIN_TEXT', 'content': 'Enjoy your vacation!' } }" "https://language.googleapis.com/v2/documents:analyzeSentiment"
Se non specifichi document.language_code
, la lingua verrà automaticamente
rilevato. Per informazioni sulle lingue supportate dall'API Natural Language,
consulta la sezione Supporto lingue. Consulta:
Document
documentazione di riferimento per ulteriori informazioni sulla configurazione del corpo della richiesta.
Se la richiesta riesce, il server restituisce un codice di stato HTTP 200 OK
e
la risposta in formato JSON:
{ "documentSentiment": { "magnitude": 0.8, "score": 0.8 }, "language": "en", "sentences": [ { "text": { "content": "Enjoy your vacation!", "beginOffset": 0 }, "sentiment": { "magnitude": 0.8, "score": 0.8 } } ] }
documentSentiment.score
indica un sentiment positivo con un valore maggiore di zero e un sentiment negativo con un valore minore di zero.
gcloud
Per informazioni dettagliate, consulta il comando analyze-sentiment
.
Per eseguire l'analisi del sentiment, utilizza gcloud CLI
utilizza il flag --content
per identificare i contenuti da analizzare:
gcloud ml language analyze-sentiment --content="Enjoy your vacation!"
Se la richiesta riesce, il server restituisce una risposta in formato JSON:
{ "documentSentiment": { "magnitude": 0.8, "score": 0.8 }, "language": "en", "sentences": [ { "text": { "content": "Enjoy your vacation!", "beginOffset": 0 }, "sentiment": { "magnitude": 0.8, "score": 0.8 } } ] }
documentSentiment.score
indica un sentiment positivo con un valore maggiore di zero e un valore negativo
con un valore inferiore a zero.
Go
Per scoprire come installare e utilizzare la libreria client per Natural Language, vedi Librerie client di Natural Language. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Natural Language Go.
Per autenticarti a Natural Language, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Natural Language Java.
Per autenticarti a Natural Language, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per ulteriori informazioni, consulta API Natural Language Python documentazione di riferimento.
Per eseguire l'autenticazione in Natural Language, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Natural Language per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Natural Language per PHP.
Ruby: Segui le Istruzioni per la configurazione di Ruby Nella pagina delle librerie client e poi visita Documentazione di riferimento di Natural Language per Ruby.
Analisi del sentiment da Cloud Storage
Per comodità, l'API Natural Language può eseguire il sentiment l'analisi direttamente su un file situato in Cloud Storage, senza la di inviare i contenuti del file nel corpo della richiesta.
Ecco un esempio di esecuzione dell'analisi del sentiment su un file situato in Cloud spazio di archiviazione.
Protocollo
Per analizzare il sentiment di un documento archiviato in Cloud Storage,
esegui una richiesta POST
al metodo REST
documents:analyzeSentiment
e fornisci
il corpo della richiesta appropriato con il percorso del documento
come mostrato nell'esempio seguente.
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/v2/documents:analyzeSentiment"
Se non specifichi document.language_code
, la lingua verrà automaticamente
rilevato. Per informazioni sulle lingue supportate dall'API Natural Language,
consulta la sezione Supporto lingue. Consulta:
Document
documentazione di riferimento per ulteriori informazioni sulla configurazione del corpo della richiesta.
Se la richiesta riesce, il server restituisce un codice di stato HTTP 200 OK
e la risposta in formato JSON:
{ "documentSentiment": { "magnitude": 0.8, "score": 0.8 }, "language_code": "en", "sentences": [ { "text": { "content": "Enjoy your vacation!", "beginOffset": 0 }, "sentiment": { "magnitude": 0.8, "score": 0.8 } } ] }
documentSentiment.score
indica un sentiment positivo con un valore maggiore di zero e un sentiment negativo con un valore minore di zero.
gcloud
Per informazioni dettagliate, consulta il comando analyze-sentiment
.
Per eseguire l'analisi del sentiment su un file in Cloud Storage, utilizza lo strumento a riga di comando gcloud
e il flag --content-file
per identificare il percorso del file contenente i contenuti da analizzare:
gcloud ml language analyze-sentiment --content-file=gs://YOUR_BUCKET_NAME/YOUR_FILE_NAME
Se la richiesta riesce, il server restituisce una risposta in formato JSON:
{ "documentSentiment": { "magnitude": 0.8, "score": 0.8 }, "language": "en", "sentences": [ { "text": { "content": "Enjoy your vacation!", "beginOffset": 0 }, "sentiment": { "magnitude": 0.8, "score": 0.8 } } ] }
documentSentiment.score
indica un sentiment positivo con un valore maggiore di zero e un sentiment negativo con un valore minore di zero.
Go
Per scoprire come installare e utilizzare la libreria client per Natural Language, vedi Librerie client di Natural Language. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Natural Language Go.
Per eseguire l'autenticazione in Natural Language, configura Credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Java
Per scoprire come installare e utilizzare la libreria client per Natural Language, vedi Librerie client di Natural Language. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Natural Language Java.
Per autenticarti a Natural Language, configura le credenziali predefinite dell'applicazione. Per ulteriori informazioni, vedi Configura l'autenticazione per un ambiente di sviluppo locale.
Node.js
Per scoprire come installare e utilizzare la libreria client per Natural Language, vedi Librerie client di Natural Language. Per ulteriori informazioni, consulta la documentazione di riferimento dell'API Natural Language Node.js.
Per autenticarti a Natural Language, configura le credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Python
Per scoprire come installare e utilizzare la libreria client per Natural Language, consulta Librerie client di Natural Language. Per ulteriori informazioni, consulta API Natural Language Python documentazione di riferimento.
Per eseguire l'autenticazione in Natural Language, configura Credenziali predefinite dell'applicazione. Per maggiori informazioni, consulta Configurare l'autenticazione per un ambiente di sviluppo locale.
Linguaggi aggiuntivi
C#: Segui le Istruzioni per la configurazione di C# Nella pagina delle librerie client e poi visita Documentazione di riferimento di Natural Language per .NET.
PHP Segui le Istruzioni per la configurazione dei file PHP Nella pagina delle librerie client e poi visita Documentazione di riferimento di Natural Language per PHP.
Ruby: segui le istruzioni di configurazione di Ruby nella pagina delle librerie client e poi consulta la documentazione di riferimento di Natural Language per Ruby.