Visão geral da API Google Sheets

A Google Sheets API é uma interface RESTful que permite que você leia e modifique um os dados de uma planilha. Os usos mais comuns dessa API incluem os seguintes tarefas:

  • Criar planilhas
  • Ler e gravar valores de células da planilha
  • Atualizar a formatação da planilha
  • Gerenciar páginas conectadas

Veja a seguir uma lista de termos comuns usados nessa API:

Planilha

O objeto principal das Planilhas Google que pode conter várias planilhas, cada uma com informações estruturadas contidas em células. Uma Spreadsheet recurso representa cada planilha e tem um nome spreadsheetId, que contenham letras, números, hifens ou sublinhados. Você encontra ID de planilha em um URL do Planilhas Google:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Página

Uma página ou guia em uma planilha. Uma Sheet recurso representa cada página e tem um título exclusivo e valores sheetId. Você pode encontrar o ID da planilha em um URL do app Planilhas Google:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Célula

Um campo individual de texto ou dados em uma planilha. As células são organizadas em linhas e colunas, e podem ser agrupadas como um intervalo de células. Uma CellData recurso representa cada célula, mas não tem um valor de ID exclusivo. Em vez disso, use linhas e colunas coordenadas identificam as células.

Notação A1
Uma sintaxe usada para definir uma célula ou intervalo de células com uma string que contém o nome da página mais as coordenadas inicial e final da célula usando letras da coluna e números das linhas. Esse método é o método mais comum e útil ao referenciar um intervalo absoluto de células.

Mostrar exemplos

  • Sheet1!A1:B2 refere-se a todas as células nas duas primeiras linhas e colunas da Sheet1.
  • Sheet1!A:A refere-se a todas as células da primeira coluna da Sheet1.
  • Sheet1!1:2 refere-se a todas as células nas duas primeiras linhas da Sheet1.
  • Sheet1!A5:A refere-se a todas as células da primeira coluna da Planilha 1, a partir da linha 5 em diante.
  • A1:B2 refere-se a todas as células nas duas primeiras linhas e colunas da primeira página visível.
  • Sheet1 refere-se a todas as células da Sheet1.
  • 'Jon's_Data'!A1:D5 refere-se a todas as células nas primeiras cinco linhas e quatro colunas de uma planilha chamada "Dados_de_Jon".
  • 'My Custom Sheet'!A:A refere-se a todas as células na primeira coluna de uma página chamada "Minha planilha personalizada".
  • 'My Custom Sheet' refere-se a todas as células em "Minha página personalizada".

As aspas simples são obrigatórias para nomes de páginas com espaços, caracteres especiais ou uma combinação alfanumérica.

Dica: sempre que possível, use nomes diferentes para objetos nas planilhas. Por exemplo, A1 refere-se à célula A1 na primeira página visível, enquanto A1 se refere a todas as células em uma página chamada "A1". Da mesma forma, Sheet1 se refere a todas as células da Sheet1. No entanto, se houver um intervalo nomeado chamado "Sheet1", a Sheet1 vai se referir ao intervalo nomeado e Sheet1 se referir à planilha.
Notação R1C1
Uma sintaxe usada para definir uma célula ou intervalo de células com uma string que contém o nome da página mais as coordenadas inicial e final da célula usando números de linha e de coluna. Esse método é menos comum que a notação A1, mas pode ser útil ao fazer referência a um intervalo de células relativo a um determinado a posição da célula.

Mostrar exemplos

  • Sheet1!R1C1:R2C2 faz referência às duas primeiras células das duas primeiras linhas da Sheet1.
  • R1C1:R2C2 faz referência às duas primeiras células das duas primeiras linhas da primeira página visível.
  • Sheet1!R[3]C[1] refere-se à célula que está três linhas abaixo e uma coluna à direita da célula atual.
Intervalo nomeado
Uma célula ou intervalo de células definido com um nome personalizado para simplificar referências em um aplicativo. Uma FilterView recurso representa um intervalo nomeado.
Intervalo protegido
Uma célula ou intervalo de células definido que não pode ser modificado. Um ProtectedRange recurso representa um intervalo protegido.