Esta seção apresenta codelab, que você pode para se familiarizar com a API Google Sheets. Também é fornecido um conjunto de "receita" que demonstram como traduzir um arquivo criado em Planilhas Google em uma solicitação de API.
Muitas vezes, há mais de uma maneira de concluir uma determinada tarefa com a API. Quando você está decidindo sobre como abordar uma tarefa, tenha o seguinte em mente:
- Caso você precise ler ou gravar valores de células, o
spreadsheets.valuesé uma escolha melhor do que ospreadsheets. A primeira interface é mais fácil de usar para operações simples de leitura/gravação. Sempre que possível, use os métodos em lote (
spreadsheet.batchUpdate,spreadsheet.values.batchGet, espreadsheet.values.batchUpdate) para agrupar várias solicitações em uma única chamada de método. Ao usar esses recursos melhora a eficiência porque:- Reduza a sobrecarga de HTTP do cliente.
- Reduza o número de consultas feitas.
- Reduza o número de revisões no documento.
- Garantir a atomicidade de todas as alterações no lote.
Receitas
Os exemplos listados nesta seção demonstram como expressar ações comuns em Planilhas como Planilhas Google v4.
Esses exemplos são apresentados na forma de solicitações HTTP para serem neutras. Para saber como implementar protocolos de solicitação da API Sheets em uma linguagem específica usando as bibliotecas de cliente das APIs do Google, consulte a página de documentação gravar célula valores e Atualizar guias de planilhas.
As receitas nesta seção estão divididas nas seguintes categorias:
- Leitura básica: receitas que mostram como ler valores de uma planilha.
- Escrita básica: receitas que mostram como gravar valores em uma planilha.
- Formatação básica: receitas que são mostradas como alterar a aparência de páginas e células.
- Gráficos: receitas que mostram como criar e alterar gráficos em uma planilha.
- Condicional formatação: receitas que mostram como alterar a aparência das células com base nas condições.
- Operações de dados: receitas que mostram como criar, mover e manipular dados em uma planilha.
- Nomeado e intervalos protegidos: receitas que mostram como criar, atualizar e remover intervalos nomeados e protegidos em uma planilha.
- Tabelas dinâmicas: receitas que mostram como para criar tabelas dinâmicas em uma planilha.
- Linha e operações de coluna: receitas que mostram como adicionar, remover e mover linhas e colunas, além de atualizar propriedades.
- Operações da planilha: receitas que mostram como criar, limpar, copiar e excluir planilhas, além de controlar suas propriedades.