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 abaixo uma lista de termos comuns usados na API Sheets:

Planilha

O objeto principal das Planilhas Google que pode conter várias planilhas, cada uma com informações estruturadas contidas em células. Um Os recursos da planilha representam todas as planilhas e têm valor exclusivo de spreadsheetId, que contenham letras, números, hifens ou sublinhados. Encontre a 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. Um Recurso da planilha 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 linhas e colunas, e podem ser agrupadas como um intervalo de células. Um O recurso CellData representa cada célula, mas ele não tem um valor de ID exclusivo. Em vez disso, você pode usar linhas e as coordenadas de coluna 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 faz referência às duas primeiras células das duas primeiras linhas 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 faz referência às duas primeiras células das duas primeiras linhas da primeira página visível.
  • Sheet1 refere-se a todas as células da Sheet1.
  • 'My Custom Sheet'!A:A refere-se a todas as células na primeira coluna de uma página chamada "Minha planilha personalizada". As aspas simples são obrigatórias para nomes de páginas com espaços, caracteres especiais ou uma combinação alfanumérica.
  • 'My Custom Sheet' refere-se a todas as células em "Minha planilha personalizada".

Dica: sempre que possível, use nomes diferentes para os objetos nas planilhas. Por exemplo, A1 refere-se à célula A1 na primeira página visível, enquanto "A1" refere-se a todas as células em uma planilha 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" refere-se à 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 ao posição

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. Um O recurso FilterView representa um intervalo nomeado.

Intervalo protegido

Uma célula definida ou um intervalo de células que não pode ser modificado. Um O recurso ProtectedRange representa um intervalo protegido.

Próximas etapas