Como Criar um Painel de Futebol Pessoal Usando APIs Gratuitas e o Google Sheets
Como Criar um Dashboard Pessoal de Futebol Usando APIs Gratuitas e Google Sheets
Crie o Seu Próprio Rastreador de Resultados ao Vivo Hoje
A maioria das aplicações de resultados enche o feed com ligas que nunca vê, esconde as equipas que lhe interessam sob separadores e dispara notificações por cada golo num torneio que ignorou. Não consegue filtrar o ruído sem pagar um escalão premium que continua a mostrar anúncios. Um Google Sheet alimentado por uma API gratuita inverte esse modelo. Decide exatamente que clubes aparecem (digamos, Arsenal, Bayern Munique e Boca Juniors) e mais nada. Os dados atualizam quando abre a folha ou num temporizador que define, não quando um servidor de push decide. Sem banners, sem píxeis de rastreio, sem conta necessária além da chave da API. Os escalões gratuitos da API-Football e da Football-Data.org permitem centenas de chamadas por dia, mais do que suficiente para uma lista pessoal de jogos. A folha fica no Drive, pelo que abre no telemóvel, no portátil ou num link partilhado com a família sem complicações de sincronização. É dono da disposição, das cores e da lógica; nada fica obsoleto porque uma equipa de produto mudou de direção.
Precisa de uma conta Google, cerca de quinze minutos e zero experiência de programação. O tutorial abrange três opções de API gratuitas: API-Football via RapidAPI, Football-Data.org e API-Football direct. Cada uma oferece um escalão gratuito de cerca de 100 pedidos por dia, suficiente para acompanhar um punhado de clubes. Apenas aparecem fórmulas básicas do Google Sheets: IMPORTJSON para obter os dados, QUERY e FILTER para os moldar, para que nunca tenha de abrir o editor do Apps Script. Se conseguir escrever =SUM(A1:A10), consegue criar este painel. A folha fica no seu Drive, atualiza na sua agenda e acompanha-o para qualquer dispositivo onde inicie sessão. Sem cartão de crédito, sem servidor, sem janela de manutenção.
Escolha a Sua API e Obtenha as Suas Credenciais
Image: 4.2 - Trace the sleeve, by LaMenta3, CC BY-SA 2.0
O API-Football no RapidAPI dá o arranque mais rápido — uma conta no marketplace, 100 chamadas por dia e cobertura de mais de 800 ligas. O Football-Data.org dispensa o passo do cartão de crédito, impõe um ritmo suave de 10 chamadas por minuto e devolve JSON mais plano que é analisado sem problemas numa Google Sheet. O API-Football direct espelha o catálogo do RapidAPI mas reside no seu próprio painel, pelo que gere as chaves separadamente. Uma jornada típica da Premier League consome cerca de 20 chamadas se obtiver calendários, resultados ao vivo e estatísticas básicas para cada jogo. Para uma primeira versão, o Football-Data.org elimina a camada extra do RapidAPI e mantém a contabilidade da quota simples. Mude para o API-Football quando precisar de alinhamentos, mapas de calor de jogadores ou feeds de xG que o Football-Data.org não disponibiliza.
Registe-se no football-data.org, confirme o e-mail e abra o painel para copiar o seu X-Auth-Token. Cole este URL na barra de endereços do navegador: https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15. Adicione o cabeçalho X-Auth-Token: YOUR_TOKEN usando uma ferramenta como o ModHeader ou o inspetor de rede integrado. Uma resposta bem-sucedida devolve JSON com um objeto competition e um array matches. Cada entrada de jogo inclui utcDate, homeTeam.name, awayTeam.name e um objeto score contendo fullTime.home e fullTime.away. Verifique os cabeçalhos da resposta para X-RateLimit-Limit e X-RateLimit-Remaining para confirmar o limite de 10 pedidos por minuto. Se vir um 403, o token está em falta ou malformado; um 429 significa que atingiu o limite por minuto.
Importar Dados de Futebol em Direto para o Google Sheets
O Google Sheets não tem um analisador JSON integrado, pelo que precisa de instalar o Apps Script uma única vez. Abra Extensões > Apps Script, apague o código inicial e cole a função IMPORTJSON do gist do GitHub do Brad Jasper. Guarde o projeto, volte para a folha e autorize o script quando solicitado — é uma concessão de permissão padrão, não um risco de segurança. A assinatura da função é =IMPORTJSON(url, query, parseOptions). Use noHeaders em parseOptions para suprimir a linha de cabeçalho automática. Exemplo: =IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches?dateFrom=2024-01-15&dateTo=2024-01-15", "/matches", "noHeaders"). As funções personalizadas só recalculam quando os seus argumentos mudam ou a folha é editada; não se atualizam automaticamente com base num temporizador. Planeie a próxima secção tendo em conta essa limitação.
=IMPORTJSON(
"https://api.football-data.org/v4/competitions/PL/matches?dateFrom="&TEXT(TODAY(),"yyyy-mm-dd")&"&dateTo="&TEXT(TODAY(),"yyyy-mm-dd"), // URL with dynamic today's date
"matches[*].[utcDate,homeTeam.name,awayTeam.name,score.fullTime.home,score.fullTime.away]", // JSONPath query: extract date, home, away, home score, away score
"noHeaders" // parseOption: suppress header row
)
Envolva a chamada IMPORTJSON em QUERY para manter apenas os jogos terminados, ordenar por hora de início e expor colunas limpas: =QUERY(IMPORTJSON(...), "SELECT Col1, Col2, Col3, Col4, Col5 WHERE Col4 IS NOT NULL ORDER BY Col1", 0). Col1 é a string de data UTC, Col2 equipa da casa, Col3 equipa visitante, Col4 golos da casa, Col5 golos visitante. Converta UTC para hora local com um ARRAYFORMULA junto aos dados: =ARRAYFORMULA(SE(COMPRIM(A2:A), TEXTO(A2:A+TEMPO(1,0,0), "ddd dd/mm HH:mm"), )); ajuste o deslocamento TEMPO para o seu fuso. Mostre apenas os clubes que segue filtrando o intervalo de resultados: =FILTER(B2:F, REGEXMATCH(B2:B, "Arsenal|Liverpool|Chelsea") + REGEXMATCH(C2:C, "Arsenal|Liverpool|Chelsea")). O sinal de mais funciona como lógica OU nas colunas de casa e fora. Estas três fórmulas — QUERY, ARRAYFORMULA, FILTER — transformam um despejo JSON bruto numa lista pessoal de jogos que atualiza sempre que a folha recalcula, sem necessidade de gatilhos Apps Script.
Automatize a Atualização e Aprimore o Seu Dashboard
Funções personalizadas como o IMPORTJSON só recalculam quando a folha abre ou quando as suas entradas mudam, pelo que a lista de jogos fica desatualizada até intervir. A correção mais leve é um Apps Script de cinco linhas que escreve um carimbo de data/hora numa célula fora do caminho (a Z1 funciona bem), forçando todas as fórmulas dependentes a reavaliar. Cole isto em Extensões → Apps Script:
Guarde, depois clique no ícone do relógio (Acionadores) → Adicionar Acionador → escolha triggerRefresh, controlado por tempo, temporizador de hora, a cada hora. Isso resulta em 24 chamadas API por dia, confortavelmente abaixo do escalão gratuito de 100 chamadas no RapidAPI e do teto de 10 por minuto no Football-Data.org. Se preferir zero manutenção de script, um Ctrl+R manual (Cmd+R no Mac) atualiza a folha a pedido. Qualquer das abordagens fecha a lacuna do "em direto" sem um único suplemento pago ou automação complexa.
Crie um seletor de competição na célula A1 através de Dados → Validação de dados → Lista a partir de um intervalo e, em seguida, escreva os seis códigos de competição: PL, UCL, PD, BL1, SA, FL1. Reescreva o URL do IMPORTJSON para ler essa célula, de modo que o dashboard mude de competição instantaneamente:
Aplique formatação condicional às colunas de resultado (assuma golos da casa na coluna D, golos fora na coluna E). Selecione as linhas dos jogos, escolha Formatar → Formatação condicional → Fórmula personalizada é e adicione três regras:
=$D2>$E2→ preenchimento verde (vitória da casa)=$D2<$E2→ preenchimento vermelho (vitória fora)=$D2=$E2→ preenchimento amarelo (empate)
As cores atualizam automaticamente à medida que os resultados chegam. Por fim, partilhe a folha: Ficheiro → Partilhar → Qualquer pessoa com a ligação → Visualizador. Para uma incorporação pública, use Ficheiro → Partilhar → Publicar na Web → Documento inteiro → Ligação e, depois, cole o iframe onde precisar.
Manter o Seu Dashboard de Futebol a Funcionar a Longo Prazo
Image: DIY Suitcase Table, by Stacie Stacie Stacie, CC BY-SA 2.0
Os escalões gratuitos mudam sem aviso; o Football-Data.org reduziu o limite diário em 2023, por isso trate a quota como um alvo móvel. Cada resposta traz cabeçalhos que revelam o estado em tempo real: X-RequestCounter-Reset indica quando a janela repõe, e X-Requests-Available mostra o saldo restante. Capture esses valores num separador oculto chamado _quota com uma chamada IMPORTJSON leve apontada ao caminho dos cabeçalhos, por exemplo:
=IMPORTJSON("https://api.football-data.org/v4/competitions/PL/matches", "headers[X-Requests-Available],headers[X-RequestCounter-Reset]")
Agende um acionador diário para anexar o resultado ao lado de TODAY(); uma formatação condicional simples sinaliza qualquer linha em que as chamadas disponíveis desçam abaixo de vinte. Se o teto baixar novamente, troque o URL base para o API-Football; os endpoints espelham a mesma estrutura, apenas o cabeçalho de autenticação muda de X-Auth-Token para X-RapidAPI-Key. Mantenha uma coluna sobresselente no seu seletor de competição com códigos alternativos (PL, UCL, PD, BL1, SA, FL1) para que o dashboard sobreviva a uma mudança de fornecedor com a edição de uma única célula.
- Verificar os cabeçalhos da quota, testar um endpoint, confirmar que a formatação condicional é aplicada, verificar as atualizações do carimbo de data/hora, rever a lista de equipas favoritas.
- Monitorizar erros 429, necessidade de atualizações minuto a minuto em tempo real, querer estatísticas de jogadores ou precisar de mais de 50 competições — então avaliar os escalões pagos.
O mesmo padrão IMPORTJSON que alimenta a sua lista de jogos abre a porta a um contexto mais rico sem novas ferramentas. Troque o endpoint para /competitions/PL/standings e o caminho da query para standings[0].table[].[position,team.name,played,won,draw,lost,points] para uma tabela ao vivo; use /competitions/PL/scorers com scorers[].[player.name,team.name,goals] para acompanhar a corrida à bota de ouro; ou obtenha a forma recente de um único clube via /teams/57/matches?limit=5&status=FINISHED (substitua 57 por qualquer ID de equipa da referência do Football-Data.org). Cada chamada devolve JSON plano que o QUERY pode remodelar em colunas limpas, para que possa colocar classificações, marcadores e forma lado a lado numa única folha. A documentação interativa do fornecedor em docs.football-data.org permite testar todos os parâmetros antes de colar o URL. O seu dashboard agora supera qualquer aplicação porque mostra exatamente o que lhe interessa — nem mais, nem menos.