Exemplos

Esta seção apresenta um codelab que você pode usar para se familiarizar com a API Google Sheets. Também é fornecido um conjunto de exemplos de "receitas" que demonstram como traduzir uma ação pretendida do Planilhas Google em uma solicitação de API.

Geralmente 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élula, a coleção spreadsheets.values é uma opção melhor do que a coleção spreadsheets. A interface anterior é mais fácil de usar para operações simples de leitura/gravação.
  • Sempre que possível, use os métodos de 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:

    • Reduzir a sobrecarga de HTTP do cliente.
    • Reduzir o número de consultas realizadas.
    • 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.

Esses exemplos são apresentados na forma de solicitações HTTP para serem neutros em relação à linguagem. 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 são divididas nas seguintes categorias: