Com a API Google Sheets, você pode adicionar, remover e manipular linhas e colunas nas páginas. Os exemplos nesta página ilustram como algumas operações de linha e coluna comuns podem ser realizadas com a API Sheets.
Esses exemplos são apresentados na forma de solicitações HTTP para a linguagem neutra. Para saber como implementar uma atualização em lote em linguagens diferentes usando as bibliotecas de cliente das APIs do Google, consulte Atualizar planilhas.
Nesses exemplos, os marcadores SPREADSHEET_ID
e SHEET_ID
indicam onde você fornece esses IDs. Você pode encontrar o ID da planilha no URL da planilha. Consiga o ID da planilha usando o método spreadsheets.get
. 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
spreadsheets.batchUpdate
a seguir 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 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 da 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
spreadsheets.batchUpdate
a seguir mostra como usar o
AppendDimensionRequest
para anexar linhas e colunas. A primeira solicitação anexa três linhas vazias ao final de uma página, 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 da 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
spreadsheets.batchUpdate
a seguir mostra como usar o
AutoResizeDimensionsRequest
para redimensionar as colunas A:C com base no tamanho do conteúdo da coluna. O campo dimension
indica que a operação se aplica às colunas da planilha.
O protocolo da 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
spreadsheets.batchUpdate
a seguir mostra como usar o
AutoResizeDimensionsRequest
para limpar as alturas das três primeiras linhas. As alturas das linhas aumentam
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 da 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
spreadsheets.batchUpdate
a seguir mostra como usar a
DeleteDimensionRequest
para excluir as três primeiras linhas de uma página. 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 página.
O protocolo da 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
spreadsheets.batchUpdate
a seguir mostra como usar o
InsertDimensionRequest
para inserir colunas ou linhas em um índice específico, como incluir linhas vazias antes
na parte de cima de uma página. A primeira solicitação insere duas colunas vazias na coluna C.
Uma segunda solicitação insere três linhas vazias começando na linha 1.
O campo dimension
determina se a operação se aplica às colunas ou linhas de uma página.
Se for verdadeiro, o campo inheritFromBefore
informará à API Sheets para dar às novas colunas ou linhas as mesmas propriedades que a linha ou coluna anterior e, se for falsa, 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 da 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
spreadsheets.batchUpdate
a seguir mostra como usar o
MoveDimensionRequest
para mover a coluna A para a posição da coluna D. 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 página. O campo destinationIndex
determina para onde mover os
dados de origem usando um índice inicial baseado em zero.
O protocolo da 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 } }, ], }