A API do Google Sheets permite manipular os dados do Sheets fora do Google Sheets. Você pode manipulá-los por programação com sua linguagem de programação preferida ou por meio de qualquer aplicativo ou plataforma que permita se conectar a uma API. Assim, você pode usar suas planilhas do Google Sheets como bancos de dados.
Neste artigo, você vai aprender tudo sobre a API do Google Sheets: o que é, quanto custa e quais são seus limites. Também vai ver como a API funciona, as diferentes opções de conexão disponíveis e onde encontrar a documentação para sua linguagem de programação preferida.
O que é a API do Google Sheets?
A API do Google Sheets é uma interface RESTful que você pode usar para ler e gravar dados no Google Sheets. Você pode se conectar a ela a partir de outro aplicativo ou plataforma, ou com sua linguagem de programação preferida, como JavaScript, PHP e Python.
Estes são alguns dos usos mais comuns da API do Google Sheets:
- Criar planilhas
- Ler e gravar valores em células
- Atualizar a formatação
- Gerenciar Folhas conectadas
A API do Google Sheets é gratuita?
A API do Google Sheets é gratuita, mas há limites de uso para cada usuário. Se o seu aplicativo receber muito tráfego de muitos usuários, você verá uma mensagem de erro (429: Too many requests). Ou seja, se você exceder o número de solicitações, sua conta não será cobrada pelo excedente.
Limites da API do Google Sheets
A API do Google Sheets tem alguns limites integrados para proteger o sistema contra hackers. Esses limites ou cotas se aplicam tanto às solicitações de leitura quanto às de gravação.
Solicitações de leitura e gravação
As cotas abaixo se aplicam separadamente a cada tipo de solicitação: leitura e gravação.
- Por dia, por projeto: ilimitado
- Por minuto, por projeto: 300
- Por minuto, por usuário, por projeto: 60
Erros de cota baseados em tempo
A documentação da API do Google Sheets recomenda usar um algoritmo de espera exponencial para aplicar um pequeno atraso e resolver os erros de cota baseados em tempo. Para mais instruções, você pode consultar a documentação do Google Cloud Storage sobre como implementar o algoritmo de espera exponencial.
Ver cotas
Você pode visualizar e gerenciar suas cotas de várias formas.
- Google Cloud Console
- Google Cloud CLI
- API Service Usage
- Métricas de cota no Cloud Monitoring
Solicitar cotas maiores
Se você exceder suas cotas, pode solicitar cotas maiores. No entanto, para isso sua solicitação precisa atender a um conjunto de critérios rigorosos e não divulgados. Você receberá uma notificação informando se ela foi aprovada ou recusada.
Como a API do Google Sheets funciona?
A interface de programação de aplicativos (API) RESTful do Google Sheets permite interagir diretamente com suas planilhas. Você pode escolher entre programar um aplicativo ou usar uma solução sem código, de acordo com suas necessidades e seus conhecimentos de programação. Entre as soluções sem código estão aplicativos que permitem se conectar a uma API, como Tableau ou Supermetrics. Para se conectar, você precisará ativar a API e gerar a chave de API necessária.
Ativar a API do Google Sheets
Para ativar a API do Google Sheets, siga as instruções abaixo.
1. Faça login no seu Google Cloud Console.
2. Clique no menu para acessar "APIs e serviços" e, depois, "APIs e serviços ativados".
3. Clique no botão "+ ATIVAR APIS E SERVIÇOS".
4. Pesquise a API do Google Sheets, como mostrado abaixo, e clique no resultado.
5. Clique para ativar a API do Google Sheets.
6. Clique no botão azul para criar as credenciais.
7. Para definir o tipo de credencial, verifique se você selecionou a API do Google Sheets.
8. Escolha se você quer acessar dados do usuário ou dados do aplicativo.
9. Informe se você vai usar algum dos produtos listados e clique em "Próxima".
10. Digite os dados da conta solicitados.
11. Selecione o papel que você quer conceder e clique em "Concluído" para terminar.
Portal de documentação da API do Google Sheets
O Portal de documentação da API do Google Sheets oferece guias de início rápido (Quickstarts) com instruções detalhadas e o código necessário para se conectar com Go, Google Apps Script, Java, JavaScript, Node.js, e Python. Além disso, a documentação inclui instruções detalhadas e o código necessário para o seguinte:
- Criar planilhas
- Ler e gravar valores de células
- Atualizar planilhas
- Formatos de data e número
- Tabelas dinâmicas
- Formatação condicional
- Filtros
- Metadados do desenvolvedor
- Folhas conectadas
- Máscaras de campo
- Google Charts
Essas instruções e exemplos estão disponíveis para várias linguagens de programação: Google Apps Script, Java, JavaScript, Node.js, PHP, Python e Ruby.
Conclusão
Como você viu, a API do Google Sheets permite interagir com os dados do Google Sheets por programação. Você pode ler e gravar dados na sua planilha usando outras plataformas e aplicativos, incluindo os que você mesmo criar com sua linguagem de programação preferida. Assim, você pode usar o Google Sheets como banco de dados e executar consultas e funções de onde quiser.
Agora você sabe o que é a API do Google Sheets, quanto custa e quais são os principais limites de uso. Também sabe como ativar a API do Google Sheets e criar credenciais no Google Cloud Platform. Por fim, sabe como acessar a documentação de início rápido para várias linguagens de programação e a documentação completa da API do Google Sheets, com exemplos para Google Apps Script, Java, JavaScript, Node.js, PHP, Python e Ruby.
Se você prefere não escrever código, Sheetgo, uma plataforma de automação de dados com IA, pode se conectar a uma API e trazer os dados para suas planilhas de forma agendada. Para criar o script você mesmo, comece por este guia de Google Apps Script no Google Sheets.
English 
Español 
Português do Brasil 
Français