Com a API Google Sheets, você pode adicionar, remover e manipular linhas e colunas em folhas. Os exemplos nesta página ilustram como algumas linhas e colunas comuns com a API Sheets.
Esses exemplos são apresentados na forma de solicitações HTTP para serem neutras. Para saber como implementar uma atualização em lote em diferentes idiomas usando bibliotecas de clientes da API do Google, consulte Atualizar planilhas.
Nestes exemplos, os marcadores de posição SPREADSHEET_ID e SHEET_ID
indica onde você deve fornecer esses IDs. Você pode encontrar a planilha
ID no URL da planilha. Você pode receber
o ID da planilha usando o
spreadsheets.get. A
são especificados usando a notação A1. Um
exemplo de intervalo é Sheet1!A1:D5.
Ajustar a largura da coluna ou a altura da linha
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
UpdateDimensionPropertiesRequest
para atualizar a propriedade de largura da coluna A para 160 pixels. Uma segunda solicitação atualiza
a propriedade de altura da linha das três primeiras linhas como 40 pixels. O dimension
determina se a operação se aplica às colunas ou linhas de um
folha
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"properties": {
"pixelSize": 160
},
"fields": "pixelSize"
}
},
{
"updateDimensionProperties": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"properties": {
"pixelSize": 40
},
"fields": "pixelSize"
}
}
]
}
Anexar linhas ou colunas vazias
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
AppendDimensionRequest
para acrescentar linhas e colunas. A primeira solicitação anexa três linhas vazias ao
final de uma página, enquanto o segundo anexa uma única coluna vazia. O dimension
determina se a operação se aplica às colunas ou linhas de um
folha
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"length": 3
}
},
{
"appendDimension": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"length": 1
}
}
]
}
Redimensionar uma coluna automaticamente
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
AutoResizeDimensionsRequest
para redimensionar as colunas A:C, com base no tamanho do conteúdo da coluna. O dimension
indica que a operação se aplica às colunas da planilha.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Redimensionar uma linha automaticamente
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
AutoResizeDimensionsRequest
para limpar a altura das três primeiras linhas. A altura das linhas aumenta
dinamicamente com base no conteúdo das células em cada linha. O dimension
indica que a operação se aplica às linhas da planilha.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"autoResizeDimensions": {
"dimensions": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
}
]
}
Excluir linhas ou colunas
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
DeleteDimensionRequest
para excluir as três primeiras linhas de uma planilha. Uma segunda solicitação exclui as colunas B:D.
O campo dimension determina se a operação se aplica às colunas ou
linhas de uma planilha.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
}
}
},
{
"deleteDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 1,
"endIndex": 4
}
}
},
],
}
Inserir uma linha ou coluna vazia
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
InsertDimensionRequest
para inserir colunas ou linhas em um índice específico (como acrescentar linhas vazias
na parte superior de uma página). A primeira solicitação insere duas colunas vazias na coluna C.
Uma segunda solicitação insere três linhas vazias a partir da linha 1.
O campo dimension determina se a operação se aplica às colunas ou
linhas de uma planilha.
Se verdadeiro, o campo inheritFromBefore instrui a API Sheets a fornecer
as novas colunas ou linhas com as mesmas propriedades da linha ou coluna anterior e, se
false, para herdar das dimensões após as novas colunas ou linhas.
inheritFromBefore não pode ser verdadeiro se você inserir uma linha na linha 1 ou uma coluna em
coluna A.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 2,
"endIndex": 4
},
"inheritFromBefore": true
}
},
{
"insertDimension": {
"range": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 0,
"endIndex": 3
},
"inheritFromBefore": false
}
},
],
}
Mover uma linha ou coluna
O seguinte
spreadsheets.batchUpdate
um exemplo de código mostra como usar a
MoveDimensionRequest
para mover a coluna A para a posição da coluna D. Uma segunda solicitação move linhas
5–10 à posição da linha 20.
O campo dimension determina se a operação se aplica às colunas ou
linhas de uma planilha. O campo destinationIndex determina para onde mover o
usando um índice inicial baseado em zero.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "COLUMNS",
"startIndex": 0,
"endIndex": 1
},
"destinationIndex": 3
}
},
{
"moveDimension": {
"source": {
"sheetId": SHEET_ID,
"dimension": "ROWS",
"startIndex": 4,
"endIndex": 10
},
"destinationIndex": 19
}
},
],
}