A API Google Sheets é uma interface RESTful que permite a você ler e modificar os dados de uma planilha. Com a API Sheets, você pode:
- Criar planilhas
- Ler e gravar valores de células de planilhas
- Atualizar a formatação da planilha
- Gerenciar páginas conectadas
Confira a seguir uma lista de termos comuns usados na API Sheets:
- Planilha
O objeto principal nas Planilhas Google. Ele pode conter vários
Sheets
, cada um com informações estruturadas contidas emCells
. O recursospreadsheets
representa uma planilha. Ele contém um valorspreadsheetId
exclusivo.- ID da planilha
- O identificador exclusivo de uma planilha. É uma string específica que contém letras, números e alguns caracteres especiais que fazem referência a uma planilha e pode ser derivada do URL dela. Os IDs de planilhas são estáveis, mesmo que o nome delas mude.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
- Planilha
Uma página ou guia em uma planilha. O recurso
Sheets
representa uma página. Ele contém um valor numéricosheetId
exclusivo e uma planilhatitle
como parte do objetoSheetProperties
.- ID da planilha
- O identificador exclusivo de uma página específica em uma planilha. É uma string específica que contém letras, números e alguns caracteres especiais que fazem referência a uma planilha e pode ser derivada do URL dela. Os IDs de planilha são estáveis, mesmo que o nome da planilha mude. Para conferir um exemplo, consulte ID da planilha.
- Cell
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. O recurso
Cells
representa cada célula, mas não tem um valor de ID exclusivo. Em vez disso, as coordenadas de linha e coluna identificam as células.- Notação A1
- Uma sintaxe usada para definir uma célula ou um intervalo de células com uma string que contém o nome da página e as coordenadas inicial e final da célula usando letras de coluna e números de linha. Esse método é o mais comum e útil ao fazer referência a um intervalo absoluto de células.
Mostrar exemplos
Sheet1!A1:B2
se refere a todas as células nas duas primeiras linhas e colunas da planilha 1.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 a todas as células das 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
se refere a todas as células das cinco primeiras linhas e quatro colunas de uma planilha chamada "Dados_de_João".'My Custom Sheet'!A:A
se refere a todas as células da primeira coluna de uma planilha chamada "Minha planilha personalizada".'My Custom Sheet'
se refere a todas as células em "Minha planilha personalizada".
As aspas simples são necessárias para nomes de planilhas com espaços, caracteres especiais ou uma combinação alfanumérica.
Dica: sempre que possível, use nomes distintos para objetos nas planilhas. Por exemplo, A1 (sem aspas) se refere à célula A1 na primeira página visível.
'A1'
se refere a uma planilha com o nome A1. Da mesma forma, "Sheet1" se refere a uma planilha com o nome "Sheet1". No entanto, se houver um intervalo nomeado com o título "Planilha1", "Planilha1" se refere ao intervalo nomeado e'Sheet1'
se refere à planilha.- Notação R1C1
- Uma sintaxe usada para definir uma célula ou um intervalo de células com uma string que contém o nome da planilha e as coordenadas da célula inicial e final usando números de linha e de coluna. Esse método é menos comum do que a notação A1, mas pode ser útil ao referenciar um intervalo de células em relação a uma determinada posição da célula.
Mostrar exemplos
Sheet1!R1C1:R2C2
faz referência às duas primeiras células das duas primeiras linhas da planilha 1.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 as referências
em um aplicativo. Um recurso
FilterView
representa um intervalo nomeado. - Intervalo protegido
- Uma célula ou intervalo de células definido que não pode ser modificado. Um recurso
ProtectedRange
representa um intervalo protegido.
Temas relacionados
Para saber mais sobre o desenvolvimento com as APIs do Google Workspace, incluindo o processamento de autenticação e autorização, consulte Desenvolver no Google Workspace.
Para saber como configurar e executar um app da API Sheets, consulte o guia de início rápido do JavaScript.