Exemplos

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 "receitas" que mostram como traduzir uma ação pretendida do Google Sheets em uma solicitação de API.

Muitas vezes, há mais de uma maneira de concluir uma determinada tarefa com a API. Ao decidir como abordar uma tarefa, lembre-se do seguinte:

• Se você precisar ler ou gravar valores de células, a coleção spreadsheets.values será uma opção melhor do que a spreadsheets coleção. A interface do primeiro é 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, e spreadsheet.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 eles:

  • Reduza a sobrecarga 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 mudanças no lote.

Receitas

Os exemplos listados nesta seção demonstram como expressar ações comuns no Planilhas Google como solicitações da API Google Sheets v4.

Esses exemplos são apresentados na forma de solicitações HTTP para serem neutros em relação ao idioma. 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 os guias Ler e gravar valores de células e Atualizar planilhas.

As receitas nesta seção são divididas nas seguintes categorias:

• Leitura básica: receitas que mostram como ler valores de uma planilha.
• Gravação básica: receitas que mostram como gravar valores em uma planilha.
• Formatação básica: receitas que mostram como mudar a aparência de planilhas e células.
• Gráficos: receitas que mostram como criar e alterar gráficos em uma planilha.
• Formatação condicional: receitas que mostram como alterar a aparência das células com base em 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 planilha.
• Operações de linha e coluna: receitas que mostram como adicionar, remover e mover linhas e colunas, além de atualizar as propriedades delas.
• Operações com páginas: receitas que mostram como criar, limpar, copiar e excluir páginas, além de controlar as propriedades delas.