O que é
Grava as linhas do relatório em uma aba de uma planilha do Google Sheets, por meio de uma conta de serviço. Cada execução substitui a aba, ou acrescenta linhas abaixo dela.
Configurar
Cerca de 10 minutos até um canal funcionando.
- 01Crie uma chave de conta de serviço. No Google Cloud, ative a API do Google Sheets em um projeto. Depois crie uma conta de serviço e adicione a ela uma chave JSON (IAM → Contas de serviço → Chaves → Adicionar chave → JSON).
- 02Compartilhe a planilha com a conta de serviço. Abra a planilha → Compartilhar, e adicione o client_email do arquivo de chave (termina em .iam.gserviceaccount.com) como editor.
- 03Cole a chave e a planilha. Cole o arquivo JSON inteiro em JSON da conta de serviço, e o link ou o id da planilha em Planilha. Testar lê a planilha para confirmar que ela enxerga.
- 04Ligue a um relatório. Relatório → Destinos → Canal, e ponha o nome da aba no Target. As linhas são o resultado da execução já mascarado para entrega, as mesmas que o e-mail leva.
Campos
| Campo | Obrigatório | O que é |
|---|---|---|
| Planilha | Sim | O link do navegador, ou o id entre /d/ e /edit nele. (https://docs.google.com/spreadsheets/d/…/edit) |
| JSON da conta de serviço | Sim | Cole o arquivo de chave inteiro. Tratado como segredo. Compartilhe a planilha com o client_email dele como editor. ({"type":"service_account", …}) |
O que vai em Target
Nome da aba na planilha, ex.: Sheet1. Adicione |append para acrescentar linhas abaixo das existentes (Sheet1|append); sem isso, cada execução substitui a aba. Deixe vazio para usar a primeira aba.
Target é opcional neste canal. — nome da aba, ex.: Sheet1 (ou Sheet1|append)
Testar
Cada canal tem o botão Testar na lista de canais (Configurações → Canais). O resultado fica guardado (data, status e o erro do provedor quando houve), e um canal nunca testado aparece marcado na lista.
Conferir de ponta a ponta
- 01Relatório: abra um relatório, adicione este canal em Destinos (com o Target, se o canal pede), clique em Executar agora e abra a execução. O log diz por qual canal cada destinatário foi e o que o provedor respondeu.
- 02Alerta: em Monitoramento → Rotas de alerta, crie uma rota com este canal como passo de escalação. A rota casa por severidade e origem; a primeira que casar vence.
- 03Para disparar um alerta sem derrubar nada: use um banco de teste que você possa desligar e crie um monitor de banco apontando para ele, com intervalo curto. Quando ele cair, o alerta sai pela rota; apague o monitor depois. A mensagem traz um link de reconhecimento; clique nele e a escalação para.
- 04Regras de relatório (linhas novas, valor fora da faixa) chegam pela mesma rota, com origem "regra de relatório".
O que mais costuma dar errado
A conta de serviço só enxerga planilhas compartilhadas com o client_email dela. Compartilhe a planilha com esse endereço como editor, ou toda execução e o Testar falham com 403.