Com a API Google Sheets, você pode atualizar a formatação de células e intervalos em planilhas. Os exemplos nesta página ilustram como algumas operações de formatação comuns podem ser realizadas com a API Sheets. Você pode encontrar mais exemplos de formatação condicional na página de roteiros Formatação condicional.
Ao atualizar uma planilha, alguns tipos de solicitação podem retornar respostas.
Eles são retornados em uma matriz, com cada resposta ocupando o mesmo índice que
a solicitação correspondente. Algumas solicitações não têm respostas e, para outras, a resposta está vazia. A estrutura da resposta para estes exemplos pode ser encontrada em
spreadsheets.batchUpdate.
Esses exemplos são apresentados na forma de solicitações HTTP para serem de linguagem neutra. Para saber como implementar uma atualização em lote em diferentes idiomas usando as bibliotecas de cliente da API do Google, consulte Atualizar planilhas.
Nesses exemplos, os marcadores de posição SPREADSHEET_ID e SHEET_ID
indicam onde você forneceria esses IDs. O ID da planilha pode ser encontrado no URL dela. É possível conseguir 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.
No vídeo acima, você aprende a formatar células da planilha de várias maneiras, incluindo: criar linhas congeladas, colocar células em negrito, implementar formatação de moeda, validar células e restringir valores de células.
Editar bordas de células
O exemplo de código
spreadsheets.batchUpdate
a seguir mostra como usar o
UpdateBordersRequest
para fornecer a cada célula do intervalo A1:F10 uma borda superior e inferior azul tracejada. O campo innerHorizontal cria bordas horizontais no interior do intervalo.
A omissão do campo resultaria na adição de bordas apenas na parte superior e inferior de todo o intervalo.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"updateBorders": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 6
},
"top": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"bottom": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
"innerHorizontal": {
"style": "DASHED",
"width": 1,
"color": {
"blue": 1.0
},
},
}
}
]
}
Formatar uma linha de cabeçalho
O exemplo de código
spreadsheets.batchUpdate
abaixo mostra como usar o
RepeatCellRequest
para formatar uma linha de cabeçalho em uma página. A primeira solicitação atualiza a cor do texto, a
cor do plano de fundo, o tamanho da fonte e a justificativa do texto, além de deixar o
texto em negrito. A omissão dos índices de coluna no campo range faz com que toda a linha seja formatada. A segunda solicitação ajusta as propriedades da página para que a linha do cabeçalho fique congelada.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 1
},
"cell": {
"userEnteredFormat": {
"backgroundColor": {
"red": 0.0,
"green": 0.0,
"blue": 0.0
},
"horizontalAlignment" : "CENTER",
"textFormat": {
"foregroundColor": {
"red": 1.0,
"green": 1.0,
"blue": 1.0
},
"fontSize": 12,
"bold": true
}
}
},
"fields": "userEnteredFormat(backgroundColor,textFormat,horizontalAlignment)"
}
},
{
"updateSheetProperties": {
"properties": {
"sheetId": SHEET_ID,
"gridProperties": {
"frozenRowCount": 1
}
},
"fields": "gridProperties.frozenRowCount"
}
}
]
}
Mesclar células
O exemplo de código
spreadsheets.batchUpdate
abaixo mostra como usar a
MergeCellsRequest
para mesclar células. A primeira solicitação mescla o intervalo A1:B2 em uma única célula. A
segunda solicitação mescla as colunas na célula A3:B6, deixando as linhas separadas.
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 2,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_ALL"
}
},
{
"mergeCells": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 2,
"endRowIndex": 6,
"startColumnIndex": 0,
"endColumnIndex": 2
},
"mergeType": "MERGE_COLUMNS"
}
},
]
}
Definir um formato personalizado de data/hora ou decimal para um intervalo
O exemplo de código
spreadsheets.batchUpdate
a seguir mostra como usar o
RepeatCellRequest
para atualizar as células para ter formatos personalizados de data e hora e números. A primeira solicitação fornece às células no intervalo A1:A10 o formato de data e hora personalizado hh:mm:ss am/pm,
ddd mmm dd yyyy. Um exemplo de data e hora nesse formato é: "02:05:07 PM, Sun 03 Abr 2016".
A segunda solicitação fornece às células em B1:B10 o formato de número personalizado
#,##0.0000, o que indica que os números precisam ser agrupados com separadores
de vírgula, que deve haver quatro dígitos após o decimal e que todos, exceto
um zero à esquerda, devem ser descartados. Por exemplo, o número "3.14" é renderizado
como "3.1400", enquanto "12345.12345" é renderizado como "12,345.1235".
Confira o protocolo da solicitação abaixo.
POST https://sheets.googleapis.com/v4/spreadsheets/SPREADSHEET_ID:batchUpdate
{
"requests": [
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 0,
"endColumnIndex": 1
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "DATE",
"pattern": "hh:mm:ss am/pm, ddd mmm dd yyyy"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
},
{
"repeatCell": {
"range": {
"sheetId": SHEET_ID,
"startRowIndex": 0,
"endRowIndex": 10,
"startColumnIndex": 1,
"endColumnIndex": 2
},
"cell": {
"userEnteredFormat": {
"numberFormat": {
"type": "NUMBER",
"pattern": "#,##0.0000"
}
}
},
"fields": "userEnteredFormat.numberFormat"
}
}
]
}