Esta seção apresenta um codelab que você pode usar para se familiarizar com a API Google Sheets. Também fornecemos um conjunto de exemplos de "receita" que demonstram como converter uma ação pretendida do Planilhas Google em uma solicitação de API.
Muitas vezes há mais de uma maneira de concluir determinada tarefa com a API. Ao decidir como abordar uma tarefa, tenha em mente o seguinte:
- Se você precisa ler ou gravar valores de células, a coleção
spreadsheets.valuesé melhor que aspreadsheets. A interface anterior é mais fácil de usar em operações simples de leitura/gravação. Sempre que possível, use os métodos de lote (
spreadsheet.batchUpdate,spreadsheet.values.batchGetespreadsheet.values.batchUpdate) para agrupar várias solicitações em uma única chamada de método. O uso desses métodos em lote melhora a eficiência porque:- Reduza a sobrecarga de HTTP do cliente.
- Reduzir o número de consultas feitas.
- Reduza o número de revisões no documento.
- Garanta a atomicidade de todas as alterações no lote.
Recipes
Os exemplos listados nesta seção demonstram como expressar ações comuns no Planilhas como solicitações da API Sheets v4.
Estes exemplos são apresentados na forma de solicitações HTTP para serem usadas com linguagem neutra. Para saber como implementar protocolos de solicitação da API Sheets em uma linguagem específica usando as bibliotecas de cliente da API do Google, consulte os guias Ler e gravar valores de célula e Atualizar planilhas.
As receitas nesta seção estão divididas nas seguintes categorias:
- Leitura básica: receitas que mostram como ler valores de uma página.
- Gravação básica: receitas que mostram como gravar valores em uma página.
- Formatação básica: receitas que mostram como alterar a aparência de páginas e células.
- Gráficos: receitas que mostram como criar e alterar gráficos em uma página.
- Formatação condicional: receitas que mostram como alterar a aparência da célula com base nas condições.
- Operações de dados: receitas que mostram como criar, mover e manipular dados em uma planilha.
- Intervalos nomeados e protegidos: receitas que mostram como criar, atualizar e remover intervalos nomeados e protegidos em uma planilha.
- Tabelas dinâmicas: receitas que mostram como criar tabelas dinâmicas em uma página.
- Operações de linha e coluna: receitas que mostram como adicionar, remover e mover linhas e colunas e atualizar as propriedades delas.
- Operações de planilha: receitas que mostram como criar, limpar, copiar e excluir páginas e também controlar as propriedades delas.