O IMPORTDATA do Google Sheets é uma ferramenta muito prática. Ela ajuda a buscar dados armazenados em arquivos .csv (valores separados por vírgula) ou .tsv (valores separados por tabulação) em um local da web.
Sintaxe da IMPORTDATA
IMPORTDATA(url, [delimitador], [localidade])
- url – obrigatório. É o endereço (localizador uniforme de recursos) na web onde o arquivo .csv ou .tsv está. Ele pode ter duas formas.
- Um local válido e totalmente qualificado na forma de texto (entre aspas duplas). Por exemplo: “http://www.census.gov/2010census/csv/pop_change.csv”
- Ou pode ser uma referência a uma célula (como B1) dentro do Google Sheets, onde a URL é armazenada.
- delimitador – opcional. O caractere que separa os valores, como um ponto e vírgula ou uma barra vertical. Se você omiti-lo, o Sheets o deduz pela extensão do arquivo: uma vírgula para .csv e uma tabulação para .tsv.
- localidade – opcional. O código de idioma e região usado para ler os dados, como en_US ou de_DE. Ele muda a forma como datas e decimais são lidos. Se você omiti-lo, o Sheets usa a localidade da planilha.
A IMPORTDATA retorna o arquivo como uma tabela que começa na célula da fórmula e preenche as células à direita e abaixo, com uma linha para cada linha do arquivo.
Pode ser útil notar que o Google Sheets acomoda até 50 fórmulas IMPORTDATA em uma única planilha.
Como usar a IMPORTDATA no Google Sheets
Caso 1: digite a URL na fórmula
Na captura de tela abaixo, tentamos importar os dados na célula B3, que é onde digitamos a fórmula IMPORTDATA.
Garantimos a url é válida e digite a fórmula corretamente (ou seja, coloque a URL entre aspas duplas) e pressione Enter. Abaixo está o que vemos enquanto o Google Sheets tenta buscar os dados. Quanto maior o arquivo, mais demora a importação.
Enquanto a importação de dados está em andamento, a célula onde inserimos a fórmula parece ter retornado um erro (indicado por um pequeno ponto vermelho no canto superior direito da célula). No entanto, não é um erro, apenas um estado transitório. Passe o mouse sobre a célula para ver a seguinte descrição.
Assim que o Planilhas Google carrega os dados, a mancha vermelha desaparece. Você notará que os dados se estendem da célula de fórmula (B3) para a direita e também para baixo.
Portanto, é de extrema importância que a coluna de destino do resultado esteja livre de quaisquer valores pré-preenchidos. Caso contrário, a fórmula IMPORTDATA poderá gerar um erro #REF! Por exemplo, a imagem a seguir ilustra o que poderia acontecer se houvesse algum valor, por exemplo, na célula C9.
Caso 2: faça referência a uma célula que contém a URL
Aqui, já armazenamos o url para o .csv na célula B1. Assim, usaremos essa célula para nos referirmos na fórmula IMPORTDATA, e o resultado é o mesmo que o do primeiro caso.
Teste com um arquivo CSV público
Para testar a IMPORTDATA com um arquivo que funciona, digite este endereço na célula A2 de uma planilha em branco: https://raw.githubusercontent.com/datasets/country-list/main/data.csv. Depois, digite =IMPORTDATA(A2) na célula D2. O Sheets retorna duas colunas, Name e Code, com uma linha por país. A captura de tela usa um endereço antigo da mesma lista.
Aprenda em esta postagem do blog como importar facilmente um feed RSS para o Google Sheets.
IMPORTDATA não funciona no Google Sheets
Como você viu, a função IMPORTDATA é muito fácil de usar. No entanto, ela tem alguns erros e limitações conhecidos.
Os dados não são atualizados
Embora você sempre possa forçar uma atualização apagando e digitando a fórmula de novo, não existe um recurso nativo para personalizar a frequência das atualizações automáticas. As funções que importam dados externos – IMPORTDATA, IMPORTHTML, IMPORTFEED e IMPORTXML – são atualizadas automaticamente a cada hora. Não há como mudar isso sem usar um script.
Uma URL por fórmula
Infelizmente, não é possível importar de várias URLs ao mesmo tempo, então você vai precisar de uma fórmula separada para cada URL. Embora seja tecnicamente possível usar essa função até 50 vezes por planilha, na prática a planilha pode ficar lenta e parar de responder.
Erro #N/A: o arquivo é grande demais
Como você pode ver na captura de tela abaixo, existe um limite para o tamanho do arquivo que pode ser importado. Você verá uma mensagem de erro dizendo que o "conteúdo do recurso no URL excedeu o tamanho máximo". O limite exato não é claro, mas é menor do que se você importasse o arquivo CSV diretamente.
Se você tiver esse problema, baixe o arquivo da URL e importe-o diretamente no Sheets.
Erro #REF!: não há colunas suficientes
A função não aumenta automaticamente o número de colunas quando necessário. Você verá uma mensagem de erro dizendo que o "resultado não foi expandido automaticamente. Insira mais colunas". Isso significa que você precisa verificar o número de colunas do arquivo de origem para garantir que sua planilha tenha colunas suficientes.
Na captura de tela acima, a URL aponta para a página do arquivo no GitHub, não para o próprio arquivo, então o Sheets tenta dividir uma página web inteira em células. No GitHub, abra o arquivo, clique em Raw e use esse endereço. Você também recebe #REF! quando células dentro do intervalo do resultado já têm valores. Limpe-as, como mostrado no caso 1.
Erro #N/A: não foi possível buscar a URL
Quem busca o arquivo são os servidores do Google, não o seu navegador. Se o arquivo estiver atrás de um login, em uma rede corporativa ou em uma pasta privada do Dropbox ou do Google Drive, a busca falha. Ela também falha quando o endereço abre uma página web que carrega os dados com JavaScript. Para verificar, abra a URL em uma janela anônima do navegador. Se você precisar fazer login, ou vir uma página em vez do arquivo, a IMPORTDATA também não consegue lê-lo.
Todos os dados ficam em uma única coluna
A IMPORTDATA divide cada linha pelo delimitador que espera: uma vírgula para arquivos .csv e uma tabulação para arquivos .tsv. Um arquivo que usa ponto e vírgula ou barras verticais precisa que você defina o delimitador manualmente, como em =IMPORTDATA(A2, ";"). Se datas ou decimais vierem errados, adicione também a localidade do arquivo, como em =IMPORTDATA(A2, ";", "de_DE") para um arquivo alemão que usa vírgulas nos decimais.
Outras formas de importar dados para o Google Sheets
A IMPORTDATA só lê arquivos CSV e TSV em uma URL pública. Para outras fontes, o Google Sheets tem mais funções de importação:
- IMPORTRANGE puxa um intervalo de células de outro arquivo do Google Sheets.
- IMPORTHTML importa uma tabela ou uma lista de uma página web.
- IMPORTXML puxa dados de páginas web e arquivos XML com uma consulta XPath.
- A IMPORTFEED importa um feed RSS ou Atom.
Para arquivos CSV no Google Drive ou no OneDrive, arquivos do Excel ou dados que você precisa atualizar de forma programada, Sheetgo, uma plataforma de automação de dados com IA, conecta esses dados à sua planilha e os atualiza automaticamente. Veja como importar CSV para o Google Sheets automaticamente, ou como importar dados CSV no Excel.
English 
Español 
Português do Brasil 
Français