Nível de programaçã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.
- Configurar 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 análises de entidade e de sentimento nas Planilhas Google, esta solução usa o UrlFetch Service para se conectar à API Google Cloud Natural Language.
Como funciona
O script coleta o texto da planilha e se conecta à API Google Cloud Natural Language para analisar as entidades e o sentimento presentes na string. Uma tabela dinâmica resume a pontuação de sentimento média de cada entidade mencionada em todas as linhas de dados de texto.
Serviços do Apps Script
Essa solução usa os seguintes serviços:
- Serviço de planilha: envia os dados de texto para a API Google Cloud Natural Language e marca cada linha como "Concluída" depois que o sentimento é analisado.
- Serviço UrlFetch: conecta-se à API Google Cloud Natural Language para realizar análises de entidade e de sentimento no texto.
Pré-requisitos
Para usar essa amostra, você precisa dos seguintes pré-requisitos:
- Uma Conta do Google (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 esta amostra:
- 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.
Ative a API Google Cloud Natural Language
Esta solução se conecta à API Google Cloud Natural Language. Antes de usar as APIs do Google, é preciso ativá-las em um projeto do Google Cloud. É possível ativar uma ou mais APIs em um único projeto do Google Cloud.
No 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 OAuth define o que o Google exibe aos usuários e registra seu app para que você possa publicá-lo mais tarde.
- No console do Google Cloud, acesse Menu > APIs e serviços > Tela de permissão OAuth.
- Em Tipo de usuário, selecione Interno e clique em Criar.
- Preencha o formulário de registro do app e clique em Salvar e continuar.
Por enquanto, é possível pular a adição de escopos e clicar em Salvar e continuar. No futuro, quando você criar um app para uso fora da sua organização do Google Workspace, será necessário alterar o Tipo de usuário para Externo e, em seguida, adicionar os escopos de autorização exigidos pelo app.
- Analise o resumo de registro do seu app. Para fazer mudanças, clique em Editar. Se o registro do app estiver correto, clique em Voltar para o painel.
Gerar 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 sua chave de 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 amostra Análise de sentimento para
feedback. O projeto do Apps Script
para esta solução está 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 comments. Você pode usar um exemplo de avaliações de propriedades de férias da Kaggle (link em inglês) ou seus próprios dados. É possível adicionar mais colunas, se necessário. No entanto, para ser executado com sucesso, 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 permissão OAuth mostrar o aviso Este app não foi verificado, continue selecionando Avançado > Acessar {Nome do projeto} (não seguro).
Clique em Ferramentas de sentimento > Marcar entidades e sentimento novamente.
Quando o script for concluído, mude para a página Tabela dinâmica para ver os resultados.
Revisar o código
Para analisar o código do Apps Script para esta solução, clique em Ver código-fonte abaixo:
Ver o código-fonte
Code.gs
Colaboradores
Esta amostra é mantida pelo Google com a ajuda de especialistas do Google Developers.
Próximas etapas
- Blog: Como analisar texto no Planilhas Google usando a API Google Cloud Natural Language e o Apps Script
- Documentação da API Google Cloud Natural Language