Nível de codificação: intermediário
Duração: 20 minutos
Tipo de projeto: automação com um menu personalizado
Objetivos
- Entenda o que a solução faz.
- Entenda o que os serviços do Apps Script fazem na solução.
- Prepare o ambiente.
- Configure o script.
- Execute o script.
Sobre esta solução
É possível analisar dados de texto, como feedback aberto, em escala. Para realizar a análise de entidades e de sentimento no Planilhas Google, essa solução usa o Serviço UrlFetch para se conectar à API Natural Language do Google Cloud.
Como funciona
O script reúne o texto da planilha e se conecta à API Google Cloud Natural Language para analisar entidades e sentimento presentes na string. Uma tabela dinâmica resume a pontuação média de sentimento para cada entidade mencionada em todas as linhas de dados de texto.
Serviços do Apps Script
Esta solução usa os seguintes serviços:
- Serviço de planilha: envia os dados de texto à API Google Cloud Natural Language e marca cada linha como "Concluída" depois que o sentimento é analisado.
- Serviço UrlFetch: se conecta à API Google Cloud Natural Language para realizar a análise de entidades e de sentimento no texto.
Pré-requisitos
Para usar este exemplo, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (as contas do Google Workspace podem exigir a aprovação do administrador).
Um navegador da Web com acesso à Internet.
Um projeto do Google Cloud com uma conta de faturamento associada. Consulte Ativar o faturamento de um projeto.
Configurar o ambiente
Abra seu projeto do Cloud no console do Google Cloud
Se ainda não estiver aberto, abra o projeto do Cloud que você pretende usar para este exemplo:
- No console do Google Cloud, acesse a página Selecionar um projeto.
- Selecione o projeto do Google Cloud que você quer usar. Ou clique em Criar projeto e siga as instruções na tela. Se você criar um projeto do Google Cloud, talvez seja necessário ativar o faturamento dele.
Ativar a API Google Cloud Natural Language
Essa solução se conecta à API Google Cloud Natural Language. Antes de usar as APIs do Google, você precisa ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.
No seu projeto do Cloud, ative a API Google Cloud Natural Language.
Configurar a tela de permissão OAuth
Essa solução requer um projeto do Cloud com uma tela de consentimento configurada. A configuração da tela de consentimento do OAuth define o que o Google mostra aos usuários e registra o app para que você possa publicá-lo mais tarde.
- No console do Google Cloud, acesse Menu > > Marca.
- Se você já tiver configurado o , poderá configurar as seguintes configurações da tela de consentimento do OAuth em Marca, Público-alvo e Acesso a dados. Se você receber a mensagem ainda não configurado, clique em Começar:
- Em Informações do app, em Nome do app, insira um nome para o app.
- Em E-mail para suporte do usuário, escolha um endereço de e-mail de suporte para que os usuários entrem em contato com você se tiverem dúvidas sobre o consentimento.
- Clique em Próxima.
- Em Público, selecione Interno.
- Clique em Próxima.
- Em Dados de contato, insira um endereço de e-mail para receber notificações sobre as mudanças no projeto.
- Clique em Próxima.
- Em Concluir, analise a Política de dados do usuário dos serviços de API do Google e, se concordar, selecione Concordo com a política de dados do usuário dos serviços de API do Google.
- Clique em Continuar.
- Clique em Criar.
- Por enquanto, você pode pular a adição de escopos. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário mudar o Tipo de usuário para Externo. Em seguida, adicione os escopos de autorização necessários para o app. Para saber mais, consulte o guia completo Configurar a permissão OAuth.
Receber uma chave de API para a API Google Cloud Natural Language
- Acesse o Console do Google Cloud. Verifique se o projeto com faturamento ativado está aberto.
No console do Google Cloud, acesse Menu > APIs e serviços > Credenciais.
Clique em Criar credenciais > Chave de API.
Anote a chave da API para usar em uma etapa posterior.
Configurar o script
Criar o projeto do Apps Script
- Clique no botão abaixo para fazer uma cópia da planilha de exemplo de Análise de sentimento para
feedback. O projeto do Apps Script para essa solução é anexado à planilha.
Fazer uma cópia - Clique em Extensões > Apps Script.
- Atualize a seguinte variável no arquivo de script com sua chave de API:
const myApiKey = 'YOUR_API_KEY'; // Replace with your API key.
- Clique em Salvar
.
Adicionar dados de texto
- Volte para a planilha.
- Adicione dados de texto às colunas ID e comentários. Você pode usar amostras de avaliações de imóveis de férias do Kaggle ou seus próprios dados. Você pode adicionar mais colunas, se necessário, mas, para ser executado, o script precisa ter dados nas colunas id e comments.
Executar o script
- Na parte de cima da planilha, clique em Ferramentas de sentimento > Marcar entidades e sentimento. Talvez seja necessário atualizar a página para que esse menu personalizado apareça.
Quando solicitado, autorize o script. Se a tela de consentimento do OAuth mostrar o aviso This app isn't verified, continue selecionando Advanced > Go to {Project Name} (unsafe).
Clique em Ferramentas de sentimento > Marcar entidades e sentimento novamente.
Quando o script terminar, mude para a planilha Tabela dinâmica para conferir os resultados.
Revisar o código
Para revisar o código do Apps Script para essa solução, clique em Ver código-fonte abaixo:
Acessar o código-fonte
Code.gs
Colaboradores
Esse exemplo é mantido pelo Google com a ajuda de especialistas em desenvolvimento do Google.
Próximas etapas
- Blog: Como analisar texto nas Planilhas Google usando a API Google Cloud Natural Language e o Apps Script
- Documentação da API Google Cloud Natural Language