A API Google Sheets permite adicionar, remover e manipular linhas e colunas em planilhas. Os exemplos nesta página ilustram como algumas operações comuns de linhas e colunas podem ser realizadas com a API Sheets.
Esses exemplos são apresentados na forma de solicitações HTTP para serem neutros em relação à linguagem. Para saber como implementar uma atualização em lote em diferentes linguagens usando as bibliotecas de cliente da API Google, consulte Atualizar planilhas.
Nesses exemplos, os marcadores de posição SPREADSHEET_ID e SHEET_ID
indicam onde você forneceria esses IDs. Você pode encontrar o ID
da planilha no URL dela. Para receber
o ID da página, use o
spreadsheets.get método. Os
intervalos 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 exemplo de código a seguir mostra como usar para atualizar a propriedade de largura da coluna A para 160 pixels.spreadsheets.batchUpdateUpdateDimensionPropertiesRequest Uma segunda solicitação atualiza a propriedade de altura da linha das três primeiras linhas para 40 pixels. O campo dimension determina se a operação se aplica às colunas ou linhas de uma planilha.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir mostra como usar para anexar linhas e colunas.spreadsheets.batchUpdateAppendDimensionRequest A primeira solicitação anexa três linhas vazias ao final de uma planilha, enquanto a segunda anexa uma única coluna vazia. O campo dimension determina se a operação se aplica às colunas ou linhas de uma planilha.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir mostra como usar para redimensionar as colunas A:C com base no tamanho do conteúdo da coluna.spreadsheets.batchUpdateAutoResizeDimensionsRequest O campo dimension indica que a operação se aplica às colunas da planilha.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir mostra como usar para limpar as alturas das três primeiras linhas.spreadsheets.batchUpdateAutoResizeDimensionsRequest As alturas das linhas crescem dinamicamente com base no conteúdo das células em cada linha. O campo dimension indica que a operação se aplica às linhas da planilha.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir
spreadsheets.batchUpdate
mostra como usar
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.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir
spreadsheets.batchUpdate
mostra como usar
InsertDimensionRequest
para inserir colunas ou linhas em um índice específico, como adicionar linhas vazias
na parte de cima de uma planilha. 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 for verdadeiro, o campo inheritFromBefore informa à API Sheets para dar às novas colunas ou linhas as mesmas propriedades da linha ou coluna anterior e, se for falso, para herdar das dimensões após as novas colunas ou linhas.
inheritFromBefore não pode ser verdadeiro se você estiver inserindo uma linha na linha 1 ou uma coluna na coluna A.
O protocolo de solicitação é mostrado 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 exemplo de código a seguir mostra como usar para mover a coluna A para a posição da coluna D.spreadsheets.batchUpdateMoveDimensionRequest Uma segunda solicitação move as linhas 5 a 10 para a 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 os dados de origem usando um índice inicial baseado em zero.
O protocolo de solicitação é mostrado 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
}
},
],
}