Conecte o Excel e o Google Sheets à Data API

Última atualização · Ver como markdown

Você pode extrair dados do AMMP Data API direto para o Excel ou Google Sheets para suas próprias análises e relatórios, e atualize sob demanda. Você precisará de uma chave de API; veja Gerenciamento de usuários.

Para consultar dados do AMMP a partir de um assistente de IA, consulte Servidor AMMP MCP.

Excel

Existem duas maneiras de se conectar: começar a partir de um modelo do AMMP ou adicionar as consultas do AMMP a uma pasta de trabalho existente. Um passo a passo em vídeo mostra a rota do modelo.

Usando o modelo do AMMP

  1. Pergunte support@ammp.io para o modelo mais recente. Há modelos para diferentes dados, como energia histórica ou potência; os endpoints correspondentes estão listados na Documentação da Data API.
  2. Abra o modelo e clique em Habilitar Edição e Habilitar Conteúdo.
  3. Go to Dados → Obter Dados → Opções de Consulta → Pasta de Trabalho Atual (Privacidade) e selecione Ignorar níveis de privacidade, para que o Excel possa obter dados externos.
  4. Clique em Iniciar o Power Query Editor.
  5. Abaixo de Parâmetros de entrada, abra Insira sua chave de API e cole sua chave.
  6. Defina a data de início em Data inicial (yyyy-MM-dd). No modelo de potência, use Inserir Horário de Início (yyyy-MM-dd hh:mm:ss, com um espaço antes do horário).
  7. Defina a data de término em Data final da mesma forma.
  8. Definir Intervalo: 1d para diário ou 1M para energia mensal; 1h or 15m no modelo de potência.
  9. Clique em Atualizar tudo. Seus ativos são carregados no Etapa 5: Selecione os Ativos. Se uma barra amarela com Editar credenciais aparecer, clique nele e depois Conectar.
  10. Para usar apenas alguns ativos, filtre o asset_id coluna.
  11. Verifique o resultado em Saída → Saída.
  12. Clique em Fechar e Carregar, depois Dados → Consultas e Conexões.
  13. Clique com o botão direito Saída e escolha Carregar para… para colocar os dados em uma planilha.

Solução de problemas

  • Erro de firewall: repita a etapa 3 (Ignore privacy levels).
  • Nenhum ativo exibido: no Power Query, ative Visualizar → Configurações de Consulta, selecione Etapa 5: Selecione os Ativos, e exclua qualquer Linhas filtradas etapa em Applied Steps.
  • Atualizando o período: abrir Dados → Consultas e Conexões, clique duas vezes no parâmetro, altere-o, clique em Fechar e Carregar, depois clique em Atualizar tudo duas vezes (dois cliques separados).

Adicionando dados da AMMP a uma pasta de trabalho existente

  1. Abra sua pasta de trabalho e o modelo do AMMP e inicie o Editor do Power Query em ambos.
  2. Copie todas as consultas do modelo e cole-as na lista de consultas da sua pasta de trabalho.
  3. Continue a partir da etapa 2 das instruções do modelo.

Google Sheets

O Google Sheets não possui modelo, pois cada usuário instala o complemento da API por conta própria.

  1. Instale o SyncWith | Any API add-on e, em seguida, abra Extensões → SyncWith | Any API → Iniciar barra lateral.
  2. Escolher Personalizado na parte inferior da lista.
  3. Criar um POST requisição para o endpoint de token da Data API (veja a Documentação da Data API) com dois cabeçalhos: accept: application/json e x-api-key: <your API key>.
  4. Clique em Pré-visualização para verificar se ele retorna um token e, em seguida, Inserir ele na primeira planilha.
  5. Crie outras requisições para os endpoints necessários, usando referências de células para o token e os parâmetros de consulta. Veja o guia do SyncWith sobre referências de células.

Dica

Uma referência de célula que aponta para um intervalo, como uma coluna de IDs de ativos, faz uma chamada de API por célula. Essa é uma maneira fácil de extrair dados de vários ativos de uma só vez.

Você também pode agendar atualizações. Os tokens expiram, portanto, certifique-se de que o agendamento renove a solicitação de token antes das solicitações de dados.