Esta página foi traduzida pela API Cloud Translation.

Class Spreadsheet

Acessar e modificar arquivos das Planilhas Google. Operações comuns são adicionar novas planilhas e colaboradores.

Métodos

Método	Tipo de retorno	Breve descrição
`addDeveloperMetadata(key)`	`Spreadsheet`	Adiciona metadados do desenvolvedor com a chave especificada à planilha de nível superior.
`addDeveloperMetadata(key, visibility)`	`Spreadsheet`	Adiciona metadados do desenvolvedor com a chave e a visibilidade especificadas à planilha.
`addDeveloperMetadata(key, value)`	`Spreadsheet`	Adiciona metadados do desenvolvedor com a chave e o valor especificados à planilha.
`addDeveloperMetadata(key, value, visibility)`	`Spreadsheet`	Adiciona metadados do desenvolvedor com a chave, o valor e a visibilidade especificados à planilha.
`addEditor(emailAddress)`	`Spreadsheet`	Adiciona o usuário à lista de editores do `Spreadsheet`.
`addEditor(user)`	`Spreadsheet`	Adiciona o usuário à lista de editores do `Spreadsheet`.
`addEditors(emailAddresses)`	`Spreadsheet`	Adiciona o array de usuários à lista de editores do `Spreadsheet`.
`addMenu(name, subMenus)`	`void`	Cria um novo menu na interface da planilha.
`addViewer(emailAddress)`	`Spreadsheet`	Adiciona o usuário à lista de espectadores do `Spreadsheet`.
`addViewer(user)`	`Spreadsheet`	Adiciona o usuário à lista de espectadores do `Spreadsheet`.
`addViewers(emailAddresses)`	`Spreadsheet`	Adiciona a matriz de usuários à lista de espectadores do `Spreadsheet`.
`appendRow(rowContents)`	`Sheet`	Anexar uma linha à parte de baixo da região de dados atual na planilha.
`autoResizeColumn(columnPosition)`	`Sheet`	Define a largura da coluna para ajustar o conteúdo.
`copy(name)`	`Spreadsheet`	Copia a planilha e retorna a nova.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Retorna um `DeveloperMetadataFinder` para encontrar metadados do desenvolvedor no escopo desta planilha.
`createTextFinder(findText)`	`TextFinder`	Cria um localizador de texto para a planilha, que pode ser usado para encontrar e substituir texto na planilha.
`deleteActiveSheet()`	`Sheet`	Exclui a planilha ativa.
`deleteColumn(columnPosition)`	`Sheet`	Exclui a coluna na posição especificada.
`deleteColumns(columnPosition, howMany)`	`void`	Exclui um número de colunas a partir da posição especificada.
`deleteRow(rowPosition)`	`Sheet`	Exclui a linha na posição especificada.
`deleteRows(rowPosition, howMany)`	`void`	Exclui um número de linhas a partir da posição especificada.
`deleteSheet(sheet)`	`void`	Exclui a planilha especificada.
`duplicateActiveSheet()`	`Sheet`	Duplica a planilha ativa e a torna a planilha ativa.
`getActiveCell()`	`Range`	Retorna a célula ativa nesta página.
`getActiveRange()`	`Range`	Retorna o intervalo selecionado na planilha ativa ou `null` se não houver um intervalo ativo.
`getActiveRangeList()`	`RangeList`	Retorna a lista de intervalos ativos na planilha ativa ou `null` se não houver intervalos ativos.
`getActiveSheet()`	`Sheet`	Retorna a página ativa em uma planilha.
`getAs(contentType)`	`Blob`	Retorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado.
`getBandings()`	`Banding[]`	Retorna todas as faixas nesta planilha.
`getBlob()`	`Blob`	Retorne os dados dentro deste objeto como um blob.
`getColumnWidth(columnPosition)`	`Integer`	Recebe a largura em pixels da coluna especificada.
`getCurrentCell()`	`Range`	Retorna a célula atual na planilha ativa ou `null` se não houver uma célula atual.
`getDataRange()`	`Range`	Retorna um `Range` correspondente às dimensões em que os dados estão presentes.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Recebe todas as fórmulas da fonte de dados.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Recebe todas as tabelas dinâmicas da fonte de dados.
`getDataSourceRefreshSchedules()`	`DataSourceRefreshSchedule[]`	Consegue as programações de atualização desta planilha.
`getDataSourceSheets()`	`DataSourceSheet[]`	Retorna todas as planilhas de origem de dados na planilha.
`getDataSourceTables()`	`DataSourceTable[]`	Recebe todas as tabelas da fonte de dados.
`getDataSources()`	`DataSource[]`	Retorna todas as fontes de dados na planilha.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Recebe os metadados do desenvolvedor associados à planilha de nível superior.
`getEditors()`	`User[]`	Recebe a lista de editores para este `Spreadsheet`.
`getFormUrl()`	`String`	Retorna o URL do formulário que envia as respostas para esta planilha ou `null` se ela não tiver um formulário associado.
`getFrozenColumns()`	`Integer`	Retorna o número de colunas congeladas.
`getFrozenRows()`	`Integer`	Retorna o número de linhas congeladas.
`getId()`	`String`	Recebe um identificador exclusivo para esta planilha.
`getImages()`	`OverGridImage[]`	Retorna todas as imagens fora da grade na página.
`getIterativeCalculationConvergenceThreshold()`	`Number`	Retorna o valor de limite usado durante o cálculo iterativo.
`getLastColumn()`	`Integer`	Retorna a posição da última coluna com conteúdo.
`getLastRow()`	`Integer`	Retorna a posição da última linha com conteúdo.
`getMaxIterativeCalculationCycles()`	`Integer`	Retorna o número máximo de iterações a serem usadas durante o cálculo iterativo.
`getName()`	`String`	Extrai o nome do documento.
`getNamedRanges()`	`NamedRange[]`	Recebe todos os intervalos nomeados nesta planilha.
`getNumSheets()`	`Integer`	Retorna o número de planilhas na planilha.
`getOwner()`	`User`	Retorna o proprietário do documento ou `null` para um documento em um drive compartilhado.
`getPredefinedSpreadsheetThemes()`	`SpreadsheetTheme[]`	Retorna a lista de temas predefinidos.
`getProtections(type)`	`Protection[]`	Recebe uma matriz de objetos que representam todos os intervalos ou planilhas protegidos na planilha.
`getRange(a1Notation)`	`Range`	Retorna o intervalo especificado na notação A1 ou R1C1.
`getRangeByName(name)`	`Range`	Retorna um intervalo nomeado ou `null` se nenhum intervalo com o nome fornecido for encontrado.
`getRangeList(a1Notations)`	`RangeList`	Retorna a coleção `RangeList` que representa os intervalos na mesma planilha especificados por uma lista não vazia de notações A1 ou R1C1.
`getRecalculationInterval()`	`RecalculationInterval`	Retorna o intervalo de cálculo para essa planilha.
`getRowHeight(rowPosition)`	`Integer`	Consegue a altura em pixels da linha especificada.
`getSelection()`	`Selection`	Retorna o `Selection` atual na planilha.
`getSheetByName(name)`	`Sheet`	Retorna uma planilha com o nome fornecido.
`getSheetId()`	`Integer`	Retorna o ID da planilha representada por este objeto.
`getSheetName()`	`String`	Retorna o nome da planilha.
`getSheetValues(startRow, startColumn, numRows, numColumns)`	`Object[][]`	Retorna a grade retangular de valores para esse intervalo, começando nas coordenadas especificadas.
`getSheets()`	`Sheet[]`	Recebe todas as planilhas.
`getSpreadsheetLocale()`	`String`	Recebe a localidade da planilha.
`getSpreadsheetTheme()`	`SpreadsheetTheme`	Retorna o tema atual da planilha ou `null` se nenhum tema estiver aplicado.
`getSpreadsheetTimeZone()`	`String`	Recebe o fuso horário da planilha.
`getUrl()`	`String`	Retorna o URL da planilha especificada.
`getViewers()`	`User[]`	Mostra a lista de leitores e comentaristas desse `Spreadsheet`.
`hideColumn(column)`	`void`	Oculta a coluna ou as colunas no intervalo especificado.
`hideRow(row)`	`void`	Oculta as linhas no intervalo especificado.
`insertColumnAfter(afterPosition)`	`Sheet`	Insere uma coluna após a posição da coluna especificada.
`insertColumnBefore(beforePosition)`	`Sheet`	Insere uma coluna antes da posição da coluna especificada.
`insertColumnsAfter(afterPosition, howMany)`	`Sheet`	Insere um determinado número de colunas após a posição da coluna especificada.
`insertColumnsBefore(beforePosition, howMany)`	`Sheet`	Insere um número de colunas antes da posição da coluna especificada.
`insertDataSourceSheet(spec)`	`DataSourceSheet`	Insere um novo `DataSourceSheet` na planilha e inicia a execução de dados.
`insertImage(blobSource, column, row)`	`OverGridImage`	Insere um `Spreadsheet` como uma imagem no documento em uma determinada linha e coluna.
`insertImage(blobSource, column, row, offsetX, offsetY)`	`OverGridImage`	Insere um `Spreadsheet` como uma imagem no documento em uma determinada linha e coluna, com um deslocamento de pixel.
`insertImage(url, column, row)`	`OverGridImage`	Insere uma imagem no documento em uma determinada linha e coluna.
`insertImage(url, column, row, offsetX, offsetY)`	`OverGridImage`	Insere uma imagem no documento em uma determinada linha e coluna, com um deslocamento de pixel.
`insertRowAfter(afterPosition)`	`Sheet`	Insere uma linha após a posição da linha especificada.
`insertRowBefore(beforePosition)`	`Sheet`	Insere uma linha antes da posição da linha especificada.
`insertRowsAfter(afterPosition, howMany)`	`Sheet`	Insere um número de linhas após a posição da linha especificada.
`insertRowsBefore(beforePosition, howMany)`	`Sheet`	Insere um número de linhas antes da posição de linha especificada.
`insertSheet()`	`Sheet`	Insere uma nova página na planilha usando um nome padrão.
`insertSheet(sheetIndex)`	`Sheet`	Insere uma nova página na planilha no índice especificado.
`insertSheet(sheetIndex, options)`	`Sheet`	Insere uma nova página na planilha no índice especificado e usa argumentos avançados opcionais.
`insertSheet(options)`	`Sheet`	Insere uma nova página na planilha usando um nome de página padrão e argumentos avançados opcionais.
`insertSheet(sheetName)`	`Sheet`	Insere uma nova página na planilha com o nome fornecido.
`insertSheet(sheetName, sheetIndex)`	`Sheet`	Insere uma nova página na planilha com o nome especificado no índice fornecido.
`insertSheet(sheetName, sheetIndex, options)`	`Sheet`	Insere uma nova planilha na planilha com o nome fornecido no índice fornecido e usa argumentos avançados opcionais.
`insertSheet(sheetName, options)`	`Sheet`	Insere uma nova página na planilha com o nome fornecido e usa argumentos avançados opcionais.
`insertSheetWithDataSourceTable(spec)`	`Sheet`	Insere uma nova planilha na planilha, cria um `DataSourceTable` que abrange toda a planilha com a especificação da fonte de dados especificada e inicia a execução de dados.
`isColumnHiddenByUser(columnPosition)`	`Boolean`	Retorna se a coluna especificada está oculta pelo usuário.
`isIterativeCalculationEnabled()`	`Boolean`	Retorna se o cálculo iterativo está ativado nesta planilha.
`isRowHiddenByFilter(rowPosition)`	`Boolean`	Retorna se a linha especificada está oculta por um filtro (não uma visualização de filtro).
`isRowHiddenByUser(rowPosition)`	`Boolean`	Retorna se a linha especificada está oculta pelo usuário.
`moveActiveSheet(pos)`	`void`	Move a planilha ativa para a posição especificada na lista de planilhas.
`moveChartToObjectSheet(chart)`	`Sheet`	Cria uma nova planilha `SheetType.OBJECT` e move o gráfico fornecido para ela.
`refreshAllDataSources()`	`void`	Atualiza todas as fontes de dados com suporte e os objetos de fonte de dados vinculados, ignorando os objetos de fonte de dados inválidos.
`removeEditor(emailAddress)`	`Spreadsheet`	Remove o usuário da lista de editores do `Spreadsheet`.
`removeEditor(user)`	`Spreadsheet`	Remove o usuário da lista de editores do `Spreadsheet`.
`removeMenu(name)`	`void`	Remove um menu adicionado por `addMenu(name, subMenus)`.
`removeNamedRange(name)`	`void`	Exclui um intervalo nomeado com o nome fornecido.
`removeViewer(emailAddress)`	`Spreadsheet`	Remove o usuário da lista de espectadores e comentaristas do `Spreadsheet`.
`removeViewer(user)`	`Spreadsheet`	Remove o usuário da lista de espectadores e comentaristas do `Spreadsheet`.
`rename(newName)`	`void`	Renomeia o documento.
`renameActiveSheet(newName)`	`void`	Renomeia a planilha ativa atual para o novo nome fornecido.
`resetSpreadsheetTheme()`	`SpreadsheetTheme`	Remove o tema aplicado e define o tema padrão na planilha.
`setActiveRange(range)`	`Range`	Define o intervalo especificado como `active range` na página ativa, com a célula superior esquerda do intervalo como `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Define a lista especificada de intervalos como `active ranges` na folha ativa.
`setActiveSelection(range)`	`Range`	Define a região de seleção ativa para esta página.
`setActiveSelection(a1Notation)`	`Range`	Define a seleção ativa, conforme especificado na notação A1 ou R1C1.
`setActiveSheet(sheet)`	`Sheet`	Define a planilha especificada como a planilha ativa.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Define a planilha especificada como a ativa na planilha, com uma opção para restaurar a seleção mais recente nessa planilha.
`setColumnWidth(columnPosition, width)`	`Sheet`	Define a largura da coluna especificada em pixels.
`setCurrentCell(cell)`	`Range`	Define a célula especificada como `current cell`.
`setFrozenColumns(columns)`	`void`	Congelar o número especificado de colunas.
`setFrozenRows(rows)`	`void`	Congelar o número especificado de linhas.
`setIterativeCalculationConvergenceThreshold(minThreshold)`	`Spreadsheet`	Define o valor mínimo de limite para o cálculo iterativo.
`setIterativeCalculationEnabled(isEnabled)`	`Spreadsheet`	Define se o cálculo iterativo está ativado nesta planilha.
`setMaxIterativeCalculationCycles(maxIterations)`	`Spreadsheet`	Define o número máximo de iterações de cálculo que precisam ser realizadas durante o cálculo iterativo.
`setNamedRange(name, range)`	`void`	Nomeia um intervalo.
`setRecalculationInterval(recalculationInterval)`	`Spreadsheet`	Define com que frequência essa planilha precisa ser recalculada.
`setRowHeight(rowPosition, height)`	`Sheet`	Define a altura da linha em pixels.
`setSpreadsheetLocale(locale)`	`void`	Define a localidade da planilha.
`setSpreadsheetTheme(theme)`	`SpreadsheetTheme`	Define um tema na planilha.
`setSpreadsheetTimeZone(timezone)`	`void`	Define o fuso horário da planilha.
`show(userInterface)`	`void`	Mostra um componente de interface do usuário personalizado em uma caixa de diálogo centralizada na viewport do navegador do usuário.
`sort(columnPosition)`	`Sheet`	Classifica uma página por coluna, em ordem crescente.
`sort(columnPosition, ascending)`	`Sheet`	Ordena uma página por coluna.
`toast(msg)`	`void`	Mostra uma janela pop-up no canto inferior direito da planilha com a mensagem.
`toast(msg, title)`	`void`	Mostra uma janela pop-up no canto inferior direito da planilha com a mensagem e o título fornecidos.
`toast(msg, title, timeoutSeconds)`	`void`	Mostra uma janela pop-up no canto inferior direito da planilha com o título e a mensagem fornecidos, que permanecem visíveis por um determinado período.
`unhideColumn(column)`	`void`	Mostra a coluna no intervalo especificado.
`unhideRow(row)`	`void`	Mostra a linha no intervalo especificado.
`updateMenu(name, subMenus)`	`void`	Atualiza um menu adicionado por `addMenu(name, subMenus)`.
`waitForAllDataExecutionsCompletion(timeoutInSeconds)`	`void`	Aguarda até que todas as execuções atuais na planilha sejam concluídas, com um tempo limite após o número de segundos fornecido.

Métodos obsoletos

Método	Tipo de retorno	Breve descrição
`getSheetProtection()`	`PageProtection`	Retorna uma instância `PageProtection` que descreve as permissões da planilha atual.
`isAnonymousView()`	`Boolean`	Indica se o documento permite visualização anônima.
`isAnonymousWrite()`	`Boolean`	Indica se o documento permite edições de usuários anônimos.
`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`	`void`	Define a política do documento para leitura e gravação anônimas.
`setSheetProtection(permissions)`	`void`	Define as permissões da planilha atual.

Documentação detalhada

`addDeveloperMetadata(key)`

Adiciona metadados do desenvolvedor com a chave especificada à planilha de nível superior.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' in the developer metadata for the spreadsheet.
ss.addDeveloperMetadata('NAME')

// Gets the first developer metadata object and logs its key.
const developerMetaData = ss.getDeveloperMetadata()[0]
console.log(developerMetaData.getKey())

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave dos novos metadados do desenvolvedor.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, visibility)`

Adiciona metadados do desenvolvedor com a chave e a visibilidade especificadas à planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility
// to the developer project that created the metadata.
ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the first developer metadata object and logs its key and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()},
.             Visibility: ${developerMetaData.getVisibility()}`);

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave dos novos metadados do desenvolvedor.
`visibility`	`DeveloperMetadataVisibility`	A visibilidade dos novos metadados do desenvolvedor.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value)`

Adiciona metadados do desenvolvedor com a chave e o valor especificados à planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the
// spreadsheet.
ss.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the first developer metadata object and logs its key and value.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave dos novos metadados do desenvolvedor.
`value`	`String`	O valor dos novos metadados do desenvolvedor.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addDeveloperMetadata(key, value, visibility)`

Adiciona metadados do desenvolvedor com a chave, o valor e a visibilidade especificados à planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to any developer project with document access.
ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the first developer metadata object and logs its key, value, and visibility setting.
const developerMetaData = ss.getDeveloperMetadata()[0];
console.log(`Key: ${developerMetaData.getKey()},
             Value: ${developerMetaData.getValue()},
             Visibility: ${developerMetaData.getVisibility()}`);

Parâmetros

Nome	Tipo	Descrição
`key`	`String`	A chave dos novos metadados do desenvolvedor.
`value`	`String`	O valor dos novos metadados do desenvolvedor.
`visibility`	`DeveloperMetadataVisibility`	A visibilidade dos novos metadados do desenvolvedor.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(emailAddress)`

Adiciona o usuário à lista de editores do Spreadsheet. Se o usuário já estava na lista de espectadores, esse método promove o usuário para fora da lista de espectadores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	O endereço de e-mail do usuário a ser adicionado.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditor(user)`

Adiciona o usuário à lista de editores do Spreadsheet. Se o usuário já estava na lista de espectadores, esse método promove o usuário para fora da lista de espectadores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser adicionado.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addEditors(emailAddresses)`

Adiciona o array de usuários à lista de editores do Spreadsheet. Se algum dos usuários já estiver na lista de espectadores, esse método vai promover a saída deles da lista de espectadores.

Parâmetros

Nome	Tipo	Descrição
`emailAddresses`	`String[]`	Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addMenu(name, subMenus)`

Cria um novo menu na interface da planilha.

Cada entrada de menu executa uma função definida pelo usuário. Normalmente, é recomendável chamar a função onOpen() para que o menu seja criado automaticamente quando a planilha for carregada.

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var menuEntries = [];
  // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is
  // executed.
  menuEntries.push({name: "Menu Entry 1", functionName: "function1"});
  menuEntries.push(null); // line separator
  menuEntries.push({name: "Menu Entry 2", functionName: "function2"});

  ss.addMenu("addMenuExample", menuEntries);
}

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do menu a ser criado.
`subMenus`	`Object[]`	Uma matriz de mapas JavaScript com parâmetros `name` e `functionName`. É possível usar funções de bibliotecas incluídas, como `Library.libFunction1`.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(emailAddress)`

Adiciona o usuário à lista de espectadores do Spreadsheet. Se o usuário já estiver na lista de editores, esse método não terá efeito.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	O endereço de e-mail do usuário a ser adicionado.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewer(user)`

Adiciona o usuário à lista de espectadores do Spreadsheet. Se o usuário já estiver na lista de editores, esse método não terá efeito.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser adicionado.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`addViewers(emailAddresses)`

Adiciona a matriz de usuários à lista de espectadores do Spreadsheet. Se algum dos usuários já estiver na lista de editores, esse método não terá efeito para eles.

Parâmetros

Nome	Tipo	Descrição
`emailAddresses`	`String[]`	Uma matriz de endereços de e-mail dos usuários a serem adicionados.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`appendRow(rowContents)`

Anexar uma linha à parte de baixo da região de dados atual na planilha. Se o conteúdo de uma célula começar com =, ele será interpretado como uma fórmula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Appends a new row with 3 columns to the bottom of the current
// data region in the sheet containing the values in the array.
sheet.appendRow(["a man", "a plan", "panama"]);

Parâmetros

Nome	Tipo	Descrição
`rowContents`	`Object[]`	Uma matriz de valores a serem inseridos após a última linha da planilha.

Retornar

Sheet: a planilha, útil para encadeamento de métodos.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`autoResizeColumn(columnPosition)`

Define a largura da coluna para ajustar o conteúdo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...');

// Sets the first column to a width which fits the text
sheet.autoResizeColumn(1);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da coluna a ser redimensionada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`copy(name)`

Copia a planilha e retorna a nova.

// This code makes a copy of the current spreadsheet and names it appropriately
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.copy("Copy of " + ss.getName());

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome da cópia.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`createDeveloperMetadataFinder()`

Retorna um DeveloperMetadataFinder para encontrar metadados do desenvolvedor no escopo desta planilha. Por padrão, isso considera todos os metadados associados à planilha, às planilhas, linhas e colunas.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds developer metadata to the spreadsheet.
ss.addDeveloperMetadata('NAME', 'CHARLIE');
ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION');
ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT');

// Creates a developer metadata finder.
const developerMetadataFinder = ss.createDeveloperMetadataFinder();

// Finds the developer metadata objects with 'COMPANY' as the key.
const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find();

// Gets the first result of developer metadata that has the key 'COMPANY' and logs its value.
console.log(googleMetadataFromSpreadsheet[0].getValue());

Retornar

DeveloperMetadataFinder: um localizador de metadados do desenvolvedor para pesquisar metadados no escopo desta planilha.

`createTextFinder(findText)`

Cria um localizador de texto para a planilha, que pode ser usado para encontrar e substituir texto na planilha. A pesquisa começa na primeira página da planilha.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();

// Creates  a text finder.
var textFinder = spreadsheet.createTextFinder('dog');

// Returns the first occurrence of 'dog' in the spreadsheet.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = findOccurrence.replaceWith('cat');

Parâmetros

Nome	Tipo	Descrição
`findText`	`String`	O texto a ser pesquisado.

Retornar

TextFinder: o TextFinder da planilha.

`deleteActiveSheet()`

Exclui a planilha ativa.

// The code below deletes the currently active sheet and stores the new active sheet in a
// variable
var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();

Retornar

Sheet: a nova página ativa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumn(columnPosition)`

Exclui a coluna na posição especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first column
sheet.deleteColumn(1);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da coluna, começando em 1 para a primeira coluna.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteColumns(columnPosition, howMany)`

Exclui um número de colunas a partir da posição especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Columns start at "1" - this deletes the first two columns
sheet.deleteColumns(1, 2);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da primeira coluna a ser excluída.
`howMany`	`Integer`	O número de colunas a serem excluídas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRow(rowPosition)`

Exclui a linha na posição especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first row
sheet.deleteRow(1);

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da linha, começando em 1 para a primeira linha.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteRows(rowPosition, howMany)`

Exclui um número de linhas a partir da posição especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Rows start at "1" - this deletes the first two rows
sheet.deleteRows(1, 2);

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da primeira linha a ser excluída.
`howMany`	`Integer`	O número de linhas a serem excluídas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`deleteSheet(sheet)`

Exclui a planilha especificada.

// The code below deletes the specified sheet.
var ss = SpreadsheetApp.getActive();
var sheet = ss.getSheetByName('My Sheet');
ss.deleteSheet(sheet);

Parâmetros

Nome	Tipo	Descrição
`sheet`	`Sheet`	A página a ser excluída.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`duplicateActiveSheet()`

Duplica a planilha ativa e a torna a planilha ativa.

// The code below makes a duplicate of the active sheet
SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveCell()`

Retorna a célula ativa nesta página.

Observação:é preferível usar getCurrentCell(), que retorna a célula realçada atual.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
// Returns the active cell
var cell = sheet.getActiveCell();

Retornar

Range: a célula ativa atual

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getActiveRange()`

Retorna o intervalo selecionado na planilha ativa ou null se não houver um intervalo ativo. Se vários intervalos forem selecionados, esse método vai retornar apenas o último intervalo selecionado.

O termo "intervalo ativo" se refere ao intervalo que um usuário selecionou na planilha ativa, mas, em uma função personalizada, ele se refere à célula que está sendo recalculada.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var activeRange = sheet.getActiveRange();

Retornar

Range: o intervalo ativo

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Consulte também

setActiveRange(range)

`getActiveRangeList()`

Retorna a lista de intervalos ativos na planilha ativa ou null se não houver intervalos ativos.

Se um único intervalo for selecionado, ele vai se comportar como uma chamada getActiveRange().

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Retornar

RangeList: a lista de intervalos ativos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Consulte também

setActiveRangeList(rangeList)

`getActiveSheet()`

Retorna a página ativa em uma planilha.

A página ativa em uma planilha é aquela que está sendo mostrada na interface da planilha.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();

Retornar

Sheet: a página ativa na planilha.

`getAs(contentType)`

Retorna os dados dentro deste objeto como um blob convertido para o tipo de conteúdo especificado. Esse método adiciona a extensão apropriada ao nome do arquivo, por exemplo, "myfile.pdf". No entanto, ele pressupõe que a parte do nome do arquivo que segue o último ponto (se houver) é uma extensão existente que precisa ser substituída. Consequentemente, "ShoppingList.12.25.2014" se torna "ShoppingList.12.25.pdf".

Para conferir as cotas diárias de conversões, consulte Cotas dos Serviços do Google. Os domínios do Google Workspace recém-criados podem estar temporariamente sujeitos a cotas mais rígidas.

Parâmetros

Nome	Tipo	Descrição
`contentType`	`String`	O tipo MIME para a conversão. Para a maioria dos blobs, `'application/pdf'` é a única opção válida. Para imagens nos formatos BMP, GIF, JPEG ou PNG, qualquer um dos formatos `'image/bmp'`, `'image/gif'`, `'image/jpeg'` ou `'image/png'` também é válido. Para um documento do Documentos Google, `'text/markdown'` também é válido.

Retornar

Blob: os dados como um blob.

`getBandings()`

Retorna todas as faixas nesta planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets an array of the bandings in the spreadsheet.
const bandings = ss.getBandings();

// Logs the range of the first banding in the spreadsheet to the console.
console.log(bandings[0].getRange().getA1Notation());

Retornar

Banding[]: as faixas nesta planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getBlob()`

Retorne os dados dentro deste objeto como um blob.

Retornar

Blob: os dados como um blob.

`getColumnWidth(columnPosition)`

Recebe a largura em pixels da coluna especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.getColumnWidth(1));

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da coluna a ser examinada.

Retornar

Integer: largura da coluna em pixels

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getCurrentCell()`

Retorna a célula atual na planilha ativa ou null se não houver uma célula atual. A célula atual é a que tem foco na interface das Planilhas Google e é destacada por uma borda escura. Nunca há mais de uma célula atual. Quando um usuário seleciona um ou mais intervalos de células, uma das células na seleção é a célula atual.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = sheet.getCurrentCell();

Retornar

Range: a célula atual

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataRange()`

Retorna um Range correspondente às dimensões em que os dados estão presentes.

Isso é funcionalmente equivalente a criar um intervalo limitado por A1 e (Sheet.getLastColumn(), Sheet.getLastRow()).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This represents ALL the data
var range = sheet.getDataRange();
var values = range.getValues();

// This logs the spreadsheet in CSV format with a trailing comma
for (var i = 0; i < values.length; i++) {
  var row = "";
  for (var j = 0; j < values[i].length; j++) {
    if (values[i][j]) {
      row = row + values[i][j];
    }
    row = row + ",";
  }
  Logger.log(row);
}

Retornar

Range: um intervalo que consiste em todos os dados da planilha

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceFormulas()`

Recebe todas as fórmulas da fonte de dados.

// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets
// file, use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source formulas on Sheet1.
// To get an array of data source formulas for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceFormulas = sheet.getDataSourceFormulas();

// Logs the first data source formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Retornar

DataSourceFormula[]: uma lista de fórmulas de fontes de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourcePivotTables()`

Recebe todas as tabelas dinâmicas da fonte de dados.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of the data source pivot tables on Sheet1.
// To get an array of data source pivot tables for the entire
// spreadsheet, replace 'sheet' with 'ss'.
const dataSourcePivotTables = sheet.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Retornar

DataSourcePivotTable[]: uma lista de tabelas dinâmicas da fonte de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceRefreshSchedules()`

Consegue as programações de atualização desta planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates BigQuery operations for the connected spreadsheet.
SpreadsheetApp.enableBigQueryExecution();

// Gets the frequency type of the first referesh schedule in the array.
const frequencyType = ss.getDataSourceRefreshSchedules()[0]
                        .getFrequency()
                        .getFrequencyType()
                        .toString();

// Logs the frequency type to the console.
console.log(frequencyType);

Retornar

DataSourceRefreshSchedule[]: as programações de atualização desta planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceSheets()`

Retorna todas as planilhas de origem de dados na planilha.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet in the spreadsheet.
const dataSource = ss.getDataSourceSheets()[0];

// Gets the name of the data source sheet.
console.log(dataSource.asSheet().getName());

Retornar

DataSourceSheet[]: uma matriz de todas as planilhas de origem de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSourceTables()`

Recebe todas as tabelas da fonte de dados.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets an array of data source tables on Sheet1.
// To get an array of data source tables for the entire spreadsheet,
// replace 'sheet' with 'ss'.
const dataSourceTables = sheet.getDataSourceTables();

// Logs the last completed data execution time on the first data source table.
console.log(dataSourceTables[0].getStatus().getLastExecutionTime());

Retornar

DataSourceTable[]: uma lista de tabelas de origem de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDataSources()`

Retorna todas as fontes de dados na planilha.

// Turns data execution on for BigQuery data sources.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the data sources on the spreadsheet.
const dataSources = ss.getDataSources();

// Logs the name of the first column on the first data source.
console.log(dataSources[0].getColumns()[0].getName());

Retornar

DataSource[]: uma matriz de todas as fontes de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getDeveloperMetadata()`

Recebe os metadados do desenvolvedor associados à planilha de nível superior.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds 'Google' as a key to the spreadsheet metadata.
ss.addDeveloperMetadata('Google');

// Gets the spreadsheet's metadata.
const ssMetadata = ss.getDeveloperMetadata();

// Gets the first set of the spreadsheet's metadata and logs the key to the console.
console.log(ssMetadata[0].getKey());

Retornar

DeveloperMetadata[]: os metadados do desenvolvedor associados a esse intervalo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getEditors()`

Recebe a lista de editores para este Spreadsheet.

Retornar

User[]: uma matriz de usuários com permissão de edição.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFormUrl()`

Retorna o URL do formulário que envia as respostas para esta planilha ou null se ela não tiver um formulário associado. Se vários formulários enviarem respostas para essa planilha, o URL do formulário retornado será indeterminado. Como alternativa, as associações de URL por formulário de planilha podem ser recuperadas pelo método Sheet.getFormUrl().

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the form URL from the spreadsheet.
const formUrl = ss.getFormUrl();

// Logs the form URL to the console.
console.log(formUrl);

Retornar

String: o URL do formulário que coloca as respostas nessa planilha ou null se ela não tiver um formulário associado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenColumns()`

Retorna o número de colunas congeladas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());

Retornar

Integer: o número de colunas congeladas

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getFrozenRows()`

Retorna o número de linhas congeladas.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());

Retornar

Integer: o número de linhas congeladas

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getId()`

Recebe um identificador exclusivo para esta planilha. O ID de uma planilha pode ser extraído do URL dela. Por exemplo, o ID da planilha no URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 é "abc1234567".

// The code below logs the ID for the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());

Retornar

String: o ID (ou chave) exclusivo da planilha.

`getImages()`

Retorna todas as imagens fora da grade na página.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the over-the-grid images from Sheet1.
// To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead.
const images = sheet.getImages();

// For each image, logs the anchor cell in A1 notation.
for (const image of images) {
 console.log(image.getAnchorCell().getA1Notation());
}

Retornar

OverGridImage[]: uma matriz de imagens sobre a grade.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getIterativeCalculationConvergenceThreshold()`

Retorna o valor de limite usado durante o cálculo iterativo. Quando os resultados de cálculos sucessivos diferem em menos do que esse valor, o cálculo iterativo é interrompido.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Retornar

Number: o limite de convergência.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastColumn()`

Retorna a posição da última coluna com conteúdo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Retornar

Integer: a última coluna da planilha que contém conteúdo

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getLastRow()`

Retorna a posição da última linha com conteúdo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This logs the value in the very last cell of this sheet
var lastRow = sheet.getLastRow();
var lastColumn = sheet.getLastColumn();
var lastCell = sheet.getRange(lastRow, lastColumn);
Logger.log(lastCell.getValue());

Retornar

Integer: a última linha da página que contém conteúdo

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getMaxIterativeCalculationCycles()`

Retorna o número máximo de iterações a serem usadas durante o cálculo iterativo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Retornar

Integer: número máximo de iterações de cálculo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getName()`

Extrai o nome do documento.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getName());

Retornar

String: o nome da planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNamedRanges()`

Recebe todos os intervalos nomeados nesta planilha.

// The code below logs the name of the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
for (var i = 0; i < namedRanges.length; i++) {
  Logger.log(namedRanges[i].getName());
}

Retornar

NamedRange[]: uma matriz de todos os intervalos nomeados na planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getNumSheets()`

Retorna o número de planilhas na planilha.

// The code below logs the number of sheets in the active spreadsheet.
Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());

Retornar

Integer: o número de planilhas na planilha.

`getOwner()`

Retorna o proprietário do documento ou null para um documento em um drive compartilhado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var owner = ss.getOwner();
Logger.log(owner.getEmail());

Retornar

User: o proprietário do documento ou null se ele estiver em um drive compartilhado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getPredefinedSpreadsheetThemes()`

Retorna a lista de temas predefinidos.

// The code below returns the list of predefined themes.
var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet()
                               .getPredefinedSpreadsheetThemes();

Retornar

SpreadsheetTheme[]: lista de temas predefinidos.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getProtections(type)`

Recebe uma matriz de objetos que representam todos os intervalos ou planilhas protegidos na planilha.

// Remove all range protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

// Remove all sheet protections in the spreadsheet that the user has permission to edit.
var ss = SpreadsheetApp.getActive();
var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET);
for (var i = 0; i < protections.length; i++) {
  var protection = protections[i];
  if (protection.canEdit()) {
    protection.remove();
  }
}

Parâmetros

Nome	Tipo	Descrição
`type`	`ProtectionType`	O tipo de área protegida, `SpreadsheetApp.ProtectionType.RANGE` ou `SpreadsheetApp.ProtectionType.SHEET`.

Retornar

Protection[]: uma matriz de objetos que representam todos os intervalos ou planilhas protegidos na planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRange(a1Notation)`

Retorna o intervalo especificado na notação A1 ou R1C1.

// Get a range A1:D4 on sheet titled "Invoices"
var ss = SpreadsheetApp.getActiveSpreadsheet();
var range = ss.getRange("Invoices!A1:D4");

// Get cell A1 on the first sheet
var sheet = ss.getSheets()[0];
var cell = sheet.getRange("A1");

Parâmetros

Nome	Tipo	Descrição
`a1Notation`	`String`	O intervalo a ser retornado, conforme especificado na notação A1 ou R1C1.

Retornar

Range: o alcance no local designado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRangeByName(name)`

Retorna um intervalo nomeado ou null se nenhum intervalo com o nome fornecido for encontrado. Se várias planilhas da planilha usarem o mesmo nome de intervalo, especifique o nome da planilha sem aspas adicionais, por exemplo, getRangeByName('TaxRates') ou getRangeByName('Sheet Name!TaxRates'), mas não getRangeByName('"Sheet Name"!TaxRates').

// Log the number of columns for the range named 'TaxRates' in the active spreadsheet.
var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates');
if (range != null) {
  Logger.log(range.getNumColumns());
}

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do intervalo a ser recebido.

Retornar

Range: o intervalo de células com o nome fornecido.

`getRangeList(a1Notations)`

Retorna a coleção RangeList que representa os intervalos na mesma planilha especificados por uma lista não vazia de notações A1 ou R1C1.

// Get a list of ranges A1:D4, F1:H4.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var rangeList  = sheet.getRangeList(['A1:D4', 'F1:H4']);

Parâmetros

Nome	Tipo	Descrição
`a1Notations`	`String[]`	A lista de intervalos a serem retornados, conforme especificado na notação A1 ou R1C1.

Retornar

RangeList: a lista de intervalos no local designado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRecalculationInterval()`

Retorna o intervalo de cálculo para essa planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Logs the calculation interval for the spreadsheet to the console.
console.log(ss.getRecalculationInterval().toString());

Retornar

RecalculationInterval: o intervalo de cálculo dessa planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getRowHeight(rowPosition)`

Consegue a altura em pixels da linha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.getRowHeight(1));

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da linha a ser examinada.

Retornar

Integer: altura da linha em pixels

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSelection()`

Retorna o Selection atual na planilha.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var currentCell = selection.getCurrentCell();

Retornar

Selection: a seleção atual

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetByName(name)`

Retorna uma planilha com o nome fornecido.

Se várias planilhas tiverem o mesmo nome, a mais à esquerda será retornada. Retorna null se não houver uma planilha com o nome fornecido.

// The code below logs the index of a sheet named "Expenses"
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses");
if (sheet != null) {
  Logger.log(sheet.getIndex());
}

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome da planilha a ser recebido.

Retornar

Sheet: a planilha com o nome fornecido.

`getSheetId()`

Retorna o ID da planilha representada por este objeto.

É um ID exclusivo da planilha. O ID é um número inteiro monotônico crescente atribuído no momento da criação da planilha, independente da posição dela. Isso é útil em conjunto com métodos como Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd), que usam um parâmetro gridId em vez de uma instância Sheet.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetId());

Retornar

Integer: um ID exclusivo para a planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetName()`

Retorna o nome da planilha.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

Logger.log(sheet.getSheetName());

Retornar

String: o nome da planilha

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheetValues(startRow, startColumn, numRows, numColumns)`

Retorna a grade retangular de valores para esse intervalo, começando nas coordenadas especificadas. Um valor -1 fornecido como a posição da linha ou coluna é equivalente a receber a última linha ou coluna que tem dados na planilha.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The two samples below produce the same output
var values = sheet.getSheetValues(1, 1, 3, 3);
Logger.log(values);

var range = sheet.getRange(1, 1, 3, 3);
values = range.getValues();
Logger.log(values);

Parâmetros

Nome	Tipo	Descrição
`startRow`	`Integer`	A posição da linha inicial.
`startColumn`	`Integer`	A posição da coluna inicial.
`numRows`	`Integer`	O número de linhas para retornar valores.
`numColumns`	`Integer`	O número de colunas para retornar valores.

Retornar

Object[][]: uma matriz bidimensional de valores

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSheets()`

Recebe todas as planilhas.

// The code below logs the name of the second sheet
var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets();
if (sheets.length > 1) {
  Logger.log(sheets[1].getName());
}

Retornar

Sheet[]: uma matriz de todas as páginas na planilha.

`getSpreadsheetLocale()`

Recebe a localidade da planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Retornar

String: a localidade da planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTheme()`

Retorna o tema atual da planilha ou null se nenhum tema estiver aplicado.

// The code below returns the current theme of the spreadsheet.
var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();

Retornar

SpreadsheetTheme: o tema aplicado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getSpreadsheetTimeZone()`

Recebe o fuso horário da planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Retornar

String: o fuso horário, especificado no formato "long" (por exemplo, "America/New_York", conforme listado por Joda.org).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getUrl()`

Retorna o URL da planilha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
Logger.log(ss.getUrl());

Retornar

String: o URL da planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`getViewers()`

Mostra a lista de leitores e comentaristas desse Spreadsheet.

Retornar

User[]: uma matriz de usuários com permissão de visualização ou comentário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideColumn(column)`

Oculta a coluna ou as colunas no intervalo especificado.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];

// This hides the first column
let range = sheet.getRange("A1");
sheet.hideColumn(range);

// This hides the first 3 columns
let range = sheet.getRange("A:C");
sheet.hideColumn(range);

Parâmetros

Nome	Tipo	Descrição
`column`	`Range`	O intervalo de colunas a ser ocultado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`hideRow(row)`

Oculta as linhas no intervalo especificado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This hides the first row
var range = sheet.getRange("A1");
sheet.hideRow(range);

Parâmetros

Nome	Tipo	Descrição
`row`	`Range`	O intervalo de linhas a ser ocultado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnAfter(afterPosition)`

Insere uma coluna após a posição da coluna especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column after the first column position
sheet.insertColumnAfter(1);

Parâmetros

Nome	Tipo	Descrição
`afterPosition`	`Integer`	A coluna após a qual a nova coluna será adicionada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnBefore(beforePosition)`

Insere uma coluna antes da posição da coluna especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a column in the first column position
sheet.insertColumnBefore(1);

Parâmetros

Nome	Tipo	Descrição
`beforePosition`	`Integer`	A coluna antes da qual a nova coluna precisa ser adicionada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsAfter(afterPosition, howMany)`

Insere um determinado número de colunas após a posição da coluna especificada.

let ss = SpreadsheetApp.getActiveSpreadsheet();
let sheet = ss.getSheets()[0];

// Inserts two columns after the first column on the first sheet of the spreadsheet.
sheet.insertColumnsAfter(1,2);

Parâmetros

Nome	Tipo	Descrição
`afterPosition`	`Integer`	A coluna depois da qual a nova coluna será adicionada.
`howMany`	`Integer`	O número de colunas a serem inseridas.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertColumnsBefore(beforePosition, howMany)`

Insere um número de colunas antes da posição da coluna especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five columns before the first column
sheet.insertColumnsBefore(1, 5);

Parâmetros

Nome	Tipo	Descrição
`beforePosition`	`Integer`	A coluna antes da qual a nova coluna precisa ser adicionada.
`howMany`	`Integer`	O número de colunas a serem inseridas.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertDataSourceSheet(spec)`

Insere um novo DataSourceSheet na planilha e inicia a execução de dados. Como efeito colateral, isso também torna a nova planilha a ativa.

Gera uma exceção se o tipo de fonte de dados não estiver ativado. Use os métodos SpreadsheetApp#enable...Execution() para ativar a execução de dados para um tipo específico de fonte de dados.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Builds a data source specification.
// TODO (developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setTableProjectId('bigquery-public-data')
 .setDatasetId('ncaa_basketball')
 .setTableId('mbb_historical_teams_games')
 .build();

// Adds the data source and its data to the spreadsheet.
ss.insertDataSourceSheet(dataSourceSpec);

Parâmetros

Nome	Tipo	Descrição
`spec`	`DataSourceSpec`	A especificação da fonte de dados a ser inserida.

Retornar

DataSourceSheet: a nova planilha da fonte de dados.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row)`

Insere um Spreadsheet como uma imagem no documento em uma determinada linha e coluna. O tamanho da imagem é extraído do conteúdo do blob. O tamanho máximo de blob aceito é 2 MB.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1);

Parâmetros

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	O blob que contém o conteúdo da imagem, o tipo MIME e (opcionalmente) o nome.
`column`	`Integer`	A posição da coluna.
`row`	`Integer`	A posição da linha.

Retornar

OverGridImage: a imagem inserida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(blobSource, column, row, offsetX, offsetY)`

Insere um Spreadsheet como uma imagem no documento em uma determinada linha e coluna, com um deslocamento de pixel. O tamanho da imagem é extraído do conteúdo do blob. O tamanho máximo de blob aceito é 2 MB.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName');
sheet.insertImage(blob, 1, 1, 10, 10);

Parâmetros

Nome	Tipo	Descrição
`blobSource`	`BlobSource`	O blob que contém o conteúdo da imagem, o tipo MIME e (opcionalmente) o nome.
`column`	`Integer`	A posição da coluna.
`row`	`Integer`	A posição da linha.
`offsetX`	`Integer`	O deslocamento horizontal da célula em pixels.
`offsetY`	`Integer`	O deslocamento vertical do canto da célula em pixels.

Retornar

OverGridImage: a imagem inserida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row)`

Insere uma imagem no documento em uma determinada linha e coluna.

O URL fornecido precisa ser acessível publicamente.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);

Parâmetros

Nome	Tipo	Descrição
`url`	`String`	É o URL da imagem.
`column`	`Integer`	A posição da coluna da grade.
`row`	`Integer`	A posição da linha da grade.

Retornar

OverGridImage: a imagem inserida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertImage(url, column, row, offsetX, offsetY)`

Insere uma imagem no documento em uma determinada linha e coluna, com um deslocamento de pixel.

O URL fornecido precisa ser acessível publicamente.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);

Parâmetros

Nome	Tipo	Descrição
`url`	`String`	O URL da imagem.
`column`	`Integer`	A posição da coluna.
`row`	`Integer`	A posição da linha.
`offsetX`	`Integer`	O deslocamento horizontal da célula em pixels.
`offsetY`	`Integer`	O deslocamento vertical do canto da célula em pixels.

Retornar

OverGridImage: a imagem inserida.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowAfter(afterPosition)`

Insere uma linha após a posição da linha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row after the first row position
sheet.insertRowAfter(1);

Parâmetros

Nome	Tipo	Descrição
`afterPosition`	`Integer`	A linha após a qual a nova linha precisa ser adicionada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowBefore(beforePosition)`

Insere uma linha antes da posição da linha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts a row before the first row position
sheet.insertRowBefore(1);

Parâmetros

Nome	Tipo	Descrição
`beforePosition`	`Integer`	A linha antes da qual a nova linha precisa ser adicionada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsAfter(afterPosition, howMany)`

Insere um número de linhas após a posição da linha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows after the first row
sheet.insertRowsAfter(1, 5);

Parâmetros

Nome	Tipo	Descrição
`afterPosition`	`Integer`	A linha depois da qual as novas linhas vão ser adicionadas.
`howMany`	`Integer`	O número de linhas a serem inseridas.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertRowsBefore(beforePosition, howMany)`

Insere um número de linhas antes da posição de linha especificada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This inserts five rows before the first row
sheet.insertRowsBefore(1, 5);

Parâmetros

Nome	Tipo	Descrição
`beforePosition`	`Integer`	A linha antes da qual as novas linhas precisam ser adicionadas.
`howMany`	`Integer`	O número de linhas a serem inseridas.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet()`

Insere uma nova página na planilha usando um nome padrão. A nova planilha se torna a ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet();

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex)`

Insere uma nova página na planilha no índice especificado. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet(1);

Parâmetros

Nome	Tipo	Descrição
`sheetIndex`	`Integer`	O índice da página recém-criada. Para inserir uma planilha como a primeira na planilha, defina-a como 0.

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetIndex, options)`

Insere uma nova página na planilha no índice especificado e usa argumentos avançados opcionais. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet(1, {template: templateSheet});

Parâmetros

Nome	Tipo	Descrição
`sheetIndex`	`Integer`	O índice da página recém-criada. Para inserir uma planilha como a primeira na planilha, defina-a como 0.
`options`	`Object`	Argumentos avançados opcionais do JavaScript.

Parâmetros avançados

Nome	Tipo	Descrição
`template`	`Sheet`	Todos os dados do objeto de planilha de modelo são copiados para a nova planilha. O modelo de página precisa ser uma das páginas do objeto "planilha".

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(options)`

Insere uma nova página na planilha usando um nome de página padrão e argumentos avançados opcionais. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet({template: templateSheet});

Parâmetros

Nome	Tipo	Descrição
`options`	`Object`	Argumentos avançados opcionais do JavaScript, listados abaixo.

Parâmetros avançados

Nome	Tipo	Descrição
`template`	`Sheet`	Todos os dados do objeto de planilha de modelo são copiados para a nova planilha. O modelo de página precisa ser uma das páginas desse objeto.

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName)`

Insere uma nova página na planilha com o nome fornecido. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet');

Parâmetros

Nome	Tipo	Descrição
`sheetName`	`String`	O nome da nova planilha.

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex)`

Insere uma nova página na planilha com o nome especificado no índice fornecido. A nova página passa a ser a ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.insertSheet('My New Sheet', 1);

Parâmetros

Nome	Tipo	Descrição
`sheetName`	`String`	O nome da nova planilha.
`sheetIndex`	`Integer`	O índice da página recém-criada. Para inserir uma planilha como a primeira na planilha, defina-a como 0.

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, sheetIndex, options)`

Insere uma nova planilha na planilha com o nome fornecido no índice fornecido e usa argumentos avançados opcionais. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', 1, {template: templateSheet});

Parâmetros

Nome	Tipo	Descrição
`sheetName`	`String`	O nome da nova planilha.
`sheetIndex`	`Integer`	O índice da página inserida. Para inserir uma planilha como a primeira em uma planilha, defina-a como 0.
`options`	`Object`	Argumentos avançados opcionais do JavaScript.

Parâmetros avançados

Nome	Tipo	Descrição
`template`	`Sheet`	Todos os dados do objeto de planilha de modelo são copiados para a nova planilha. O modelo de página precisa ser uma das páginas do objeto "planilha".

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheet(sheetName, options)`

Insere uma nova página na planilha com o nome fornecido e usa argumentos avançados opcionais. A nova página se torna a página ativa.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var templateSheet = ss.getSheetByName('Sales');
ss.insertSheet('My New Sheet', {template: templateSheet});

Parâmetros

Nome	Tipo	Descrição
`sheetName`	`String`	O nome da nova planilha.
`options`	`Object`	Argumentos avançados opcionais do JavaScript.

Parâmetros avançados

Nome	Tipo	Descrição
`template`	`Sheet`	Todos os dados do objeto de planilha de modelo são copiados para a nova planilha. O modelo de página precisa ser uma das páginas do objeto "planilha".

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`insertSheetWithDataSourceTable(spec)`

Insere uma nova planilha na planilha, cria um DataSourceTable que abrange toda a planilha com a especificação da fonte de dados especificada e inicia a execução de dados. Como efeito secundário, a nova planilha se torna a ativa.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Adds a sheet and sets cell A1 as the parameter cell.
const parameterCell = ss.insertSheet('parameterSheet').getRange('A1');

// Sets the value of the parameter cell to 'Duke'.
parameterCell.setValue('Duke');

const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' +
  '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL';

// Adds a data source with a query parameter.
// TODO(developer): Update the project ID to your own Google Cloud project ID.
const dataSourceSpec = SpreadsheetApp.newDataSourceSpec()
 .asBigQuery()
 .setProjectId('project-id-1')
 .setRawQuery(query)
 .setParameterFromCell('SCHOOL', 'parameterSheet!A1')
 .build();

// Adds sheets for the data source and data source table to the spreadsheet.
ss.insertSheetWithDataSourceTable(dataSourceSpec);

Parâmetros

Nome	Tipo	Descrição
`spec`	`DataSourceSpec`	A especificação da fonte de dados a ser inserida.

Retornar

Sheet: a nova planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isColumnHiddenByUser(columnPosition)`

Retorna se a coluna especificada está oculta pelo usuário.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Columns start at 1
Logger.log(sheet.isColumnHiddenByUser(1));

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da coluna a ser examinada.

Retornar

Boolean: true se a coluna estiver oculta, false, caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isIterativeCalculationEnabled()`

Retorna se o cálculo iterativo está ativado nesta planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Retornar

Boolean: true se o cálculo iterativo estiver ativado, false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByFilter(rowPosition)`

Retorna se a linha especificada está oculta por um filtro (não uma visualização de filtro).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByFilter(1));

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da linha a ser examinada.

Retornar

Boolean: true se a linha estiver oculta, false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isRowHiddenByUser(rowPosition)`

Retorna se a linha especificada está oculta pelo usuário.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Rows start at 1
Logger.log(sheet.isRowHiddenByUser(1));

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da linha a ser examinada.

Retornar

Boolean: true se a linha estiver oculta, false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveActiveSheet(pos)`

Move a planilha ativa para a posição especificada na lista de planilhas. Gera uma exceção se a posição for negativa ou maior que o número de páginas.

// This example assumes that there are 2 sheets in the current
// active spreadsheet: one named "first" in position 1 and another named "second"
// in position 2.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// Gets the "first" sheet and activates it.
var sheet = spreadsheet.getSheetByName("first").activate();

// Logs 'Current index of sheet: 1'
console.log("Current index of sheet: %s", sheet.getIndex());

spreadsheet.moveActiveSheet(2);

// Logs 'New index of sheet: 2'
console.log("New index of sheet: %s", sheet.getIndex());

Parâmetros

Nome	Tipo	Descrição
`pos`	`Integer`	A posição de índice 1 para mover a página ativa na lista de páginas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`moveChartToObjectSheet(chart)`

Cria uma nova planilha SheetType.OBJECT e move o gráfico fornecido para ela. Se o gráfico já estiver na própria planilha, ela será retornada sem criar uma nova.

var sheet = SpreadsheetApp.getActiveSheet();
var chart = sheet.newChart().setPosition(1, 1, 0, 0).build();
sheet.insertChart(chart);
var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);

Parâmetros

Nome	Tipo	Descrição
`chart`	`EmbeddedChart`	O gráfico a ser movido.

Retornar

Sheet: a planilha em que o gráfico está.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`refreshAllDataSources()`

Atualiza todas as fontes de dados com suporte e os objetos de fonte de dados vinculados, ignorando os objetos de fonte de dados inválidos.

Use os métodos SpreadsheetApp#enable...Execution() para ativar a execução de dados para um tipo específico de fonte de dados.

// Activates BigQuery operations.
SpreadsheetApp.enableBigQueryExecution();

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets the first data source sheet on the spreadsheet.
const dataSheet = ss.getDataSourceSheets()[0];

// Refreshes all data sources on the spreadsheet.
ss.refreshAllDataSources();

// Logs the last refreshed time of the first data source sheet.
console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(emailAddress)`

Remove o usuário da lista de editores do Spreadsheet. Esse método não impede que os usuários acessem o Spreadsheet se eles pertencerem a uma classe de usuários que têm acesso geral. Por exemplo, se o Spreadsheet for compartilhado com todo o domínio do usuário ou se o Spreadsheet estiver em um drive compartilhado que o usuário pode acessar.

Para arquivos do Drive, isso também remove o usuário da lista de visualizadores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	O endereço de e-mail do usuário a ser removido.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeEditor(user)`

Para arquivos do Drive, isso também remove o usuário da lista de visualizadores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser removido.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeMenu(name)`

Remove um menu adicionado por addMenu(name, subMenus). O argumento name precisa ter o mesmo valor da chamada correspondente para addMenu(name, subMenus).

// The onOpen function is executed automatically every time a Spreadsheet is loaded
function onOpen() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"},
                                       {name: "foo", functionName: "foo"}]);
}
function removeBadMenu() {
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  ss.removeMenu("badMenu");  // name must match the name used when added the menu
}
function foo(){
// Do nothing
}

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do menu a ser removido.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeNamedRange(name)`

Exclui um intervalo nomeado com o nome fornecido. Gera uma exceção se nenhum intervalo com o nome fornecido for encontrado na planilha.

// The code below creates a new named range "foo", and then remove it.
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("foo", ss.getActiveRange());
ss.removeNamedRange("foo");

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do intervalo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(emailAddress)`

Remove o usuário da lista de espectadores e comentaristas do Spreadsheet. Esse método não terá efeito se o usuário for um editor, não um espectador ou comentarista. Esse método também não impede que os usuários acessem o Spreadsheet se eles pertencem a uma classe de usuários que têm acesso geral. Por exemplo, se o Spreadsheet for compartilhado com todo o domínio do usuário ou se o Spreadsheet estiver em um drive compartilhado que o usuário pode acessar.

Para arquivos do Drive, isso também remove o usuário da lista de editores.

Parâmetros

Nome	Tipo	Descrição
`emailAddress`	`String`	O endereço de e-mail do usuário a ser removido.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`removeViewer(user)`

Remove o usuário da lista de espectadores e comentaristas do Spreadsheet. Esse método não terá efeito se o usuário for um editor, não um espectador. Esse método também não impede que os usuários acessem o Spreadsheet se eles pertencem a uma classe de usuários que têm acesso geral. Por exemplo, se o Spreadsheet for compartilhado com todo o domínio do usuário ou se o Spreadsheet estiver em um drive compartilhado que o usuário pode acessar.

Para arquivos do Drive, isso também remove o usuário da lista de editores.

Parâmetros

Nome	Tipo	Descrição
`user`	`User`	Uma representação do usuário a ser removido.

Retornar

Spreadsheet: Spreadsheet para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`rename(newName)`

Renomeia o documento.

var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.rename("This is the new name");

Parâmetros

Nome	Tipo	Descrição
`newName`	`String`	O novo nome do documento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`renameActiveSheet(newName)`

Renomeia a planilha ativa atual para o novo nome fornecido.

// The code below renames the active sheet to "Hello world"
SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");

Parâmetros

Nome	Tipo	Descrição
`newName`	`String`	O novo nome da planilha ativa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`resetSpreadsheetTheme()`

Remove o tema aplicado e define o tema padrão na planilha.

// The code below applies default theme on the spreadsheet.
SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();

Retornar

SpreadsheetTheme: o tema padrão.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRange(range)`

Define o intervalo especificado como active range na página ativa, com a célula superior esquerda do intervalo como current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var range = sheet.getRange('A1:D4');
sheet.setActiveRange(range);

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D4
var activeRange = selection.getActiveRange();

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	O intervalo a ser definido como ativo.

Retornar

Range: o intervalo recém-ativado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveRangeList(rangeList)`

Define a lista especificada de intervalos como active ranges na folha ativa. O último intervalo na lista é definido como active range.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
sheet.setActiveRangeList(rangeList);

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Parâmetros

Nome	Tipo	Descrição
`rangeList`	`RangeList`	A lista de intervalos a serem selecionados.

Retornar

RangeList: a lista de intervalos recém-selecionada

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(range)`

Define a região de seleção ativa para esta página.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D4");
sheet.setActiveSelection(range);

Parâmetros

Nome	Tipo	Descrição
`range`	`Range`	O intervalo a ser definido como seleção ativa.

Retornar

Range: o intervalo recém-ativado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSelection(a1Notation)`

Define a seleção ativa, conforme especificado na notação A1 ou R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

sheet.setActiveSelection("A1:D4");

Parâmetros

Nome	Tipo	Descrição
`a1Notation`	`String`	O intervalo a ser definido como ativo, conforme especificado na notação A1 ou R1C1.

Retornar

Range: o intervalo recém-ativado

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet)`

Define a planilha especificada como a planilha ativa. A interface das Planilhas Google mostra a página escolhida, a menos que ela pertença a outra planilha.

// The code below makes the first sheet active in the active spreadsheet.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);

Parâmetros

Nome	Tipo	Descrição
`sheet`	`Sheet`	A página a ser definida como ativa.

Retornar

Sheet: a página ativa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setActiveSheet(sheet, restoreSelection)`

Define a planilha especificada como a ativa na planilha, com uma opção para restaurar a seleção mais recente nessa planilha. A interface do app Planilhas Google mostra a página escolhida, a menos que ela pertença a outra planilha.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var firstSheet = spreadsheet.getSheets()[0];
var secondSheet = spreadsheet.getSheets()[1];
// Set the first sheet as the active sheet and select the range D4:F4.
spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate();

// Switch to the second sheet to do some work.
spreadsheet.setActiveSheet(secondSheet);
// Switch back to first sheet, and restore its selection.
spreadsheet.setActiveSheet(firstSheet, true);

// The selection of first sheet is restored, and it logs D4:F4
var range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parâmetros

Nome	Tipo	Descrição
`sheet`	`Sheet`	A nova página ativa.
`restoreSelection`	`Boolean`	Se `true`, a seleção mais recente da nova planilha ativa será selecionada novamente quando a nova planilha for ativada. Se `false`, a nova planilha será ativada sem mudar a seleção atual.

Retornar

Sheet: a nova página ativa.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setColumnWidth(columnPosition, width)`

Define a largura da coluna especificada em pixels.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first column to a width of 200 pixels
sheet.setColumnWidth(1, 200);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A posição da coluna a ser definida.
`width`	`Integer`	A largura em pixels para definir.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setCurrentCell(cell)`

Define a célula especificada como current cell.

Se a célula especificada estiver presente em um intervalo já selecionado, esse intervalo se tornará o intervalo ativo com a célula como a atual.

Se a célula especificada não estiver presente em nenhum intervalo selecionado, a seleção atual será removida e a célula especificada vai se tornar a célula atual e o intervalo ativo.

Observação:o Range especificado precisa consistir em uma célula. Caso contrário, uma exceção será gerada.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
var cell = sheet.getRange('B5');
sheet.setCurrentCell(cell);

var selection = sheet.getSelection();
// Current cell: B5
var currentCell = selection.getCurrentCell();

Parâmetros

Nome	Tipo	Descrição
`cell`	`Range`	A célula a ser definida como a atual.

Retornar

Range: a célula atual recém-definida

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenColumns(columns)`

Congelar o número especificado de colunas. Se for zero, nenhuma coluna será congelada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first column
sheet.setFrozenColumns(1);

Parâmetros

Nome	Tipo	Descrição
`columns`	`Integer`	O número de colunas a serem congeladas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setFrozenRows(rows)`

Congelar o número especificado de linhas. Se for zero, nenhuma linha será congelada.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Freezes the first row
sheet.setFrozenRows(1);

Parâmetros

Nome	Tipo	Descrição
`rows`	`Integer`	O número de linhas a serem congeladas.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationConvergenceThreshold(minThreshold)`

Define o valor mínimo de limite para o cálculo iterativo. Quando os resultados de cálculos sucessivos diferem em menos do que esse valor, o cálculo iterativo é interrompido. Esse valor precisa ser não negativo e tem como padrão 0, 05.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the iterative calculation convergence threshold for the spreadsheet.
ss.setIterativeCalculationConvergenceThreshold(2);

// Logs the threshold to the console.
console.log(ss.getIterativeCalculationConvergenceThreshold());

Parâmetros

Nome	Tipo	Descrição
`minThreshold`	`Number`	O limite mínimo de convergência (não pode ser negativo).

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setIterativeCalculationEnabled(isEnabled)`

Define se o cálculo iterativo está ativado nesta planilha. Se o número máximo de ciclos de cálculo e o limite de convergência não tiverem sido definidos anteriormente quando o cálculo for ativado, eles serão definidos como 50 e 0,05, respectivamente. Se um deles tiver sido definido anteriormente, eles mantêm os valores anteriores.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Activates iterative calculation on the spreadsheet.
ss.setIterativeCalculationEnabled(true);

// Logs whether iterative calculation is activated for the spreadsheet.
console.log(ss.isIterativeCalculationEnabled());

Parâmetros

Nome	Tipo	Descrição
`isEnabled`	`Boolean`	`true` se o cálculo iterativo precisa ser ativado. Caso contrário, `false`.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setMaxIterativeCalculationCycles(maxIterations)`

Define o número máximo de iterações de cálculo que precisam ser realizadas durante o cálculo iterativo. Esse valor precisa estar entre 1 e 10.000 (inclusive), e o padrão é 50.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the max iterative calculation cycles for the spreadsheet.
ss.setMaxIterativeCalculationCycles(10);

// Logs the max iterative calculation cycles to the console.
console.log(ss.getMaxIterativeCalculationCycles());

Parâmetros

Nome	Tipo	Descrição
`maxIterations`	`Integer`	O número máximo de iterações de cálculo (entre 1 e 10.000).

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setNamedRange(name, range)`

Nomeia um intervalo.

// The code below creates a new named range "TaxRates" in the active spreadsheet
var ss = SpreadsheetApp.getActiveSpreadsheet();
ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome a ser dado ao intervalo.
`range`	`Range`	A especificação do intervalo.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRecalculationInterval(recalculationInterval)`

Define com que frequência essa planilha precisa ser recalculada.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the  calculation interval for the spreadsheet to 'ON_CHANGE'.
const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE);

// Logs the calculation interval to the console.
console.log(interval);

Parâmetros

Nome	Tipo	Descrição
`recalculationInterval`	`RecalculationInterval`	O novo intervalo de recálculo.

Retornar

Spreadsheet: esta planilha, para encadeamento.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setRowHeight(rowPosition, height)`

Define a altura da linha em pixels. Por padrão, as linhas crescem para ajustar o conteúdo da célula. Se você quiser forçar as linhas a uma altura especificada, use Sheet.setRowHeightsForced(startRow, numRows, height).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sets the first row to a height of 200 pixels
sheet.setRowHeight(1, 200);

Parâmetros

Nome	Tipo	Descrição
`rowPosition`	`Integer`	A posição da linha a ser alterada.
`height`	`Integer`	A altura em pixels.

Retornar

Sheet: a planilha, útil para encadeamento de métodos.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetLocale(locale)`

Define a localidade da planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the spreadsheet locale.
ss.setSpreadsheetLocale('fr');

// Gets the spreadsheet locale.
const ssLocale = ss.getSpreadsheetLocale();

// Logs the locale to the console.
console.log(ssLocale);

Parâmetros

Nome	Tipo	Descrição
`locale`	`String`	O código de localidade a ser usado (por exemplo, "en", "fr" ou "en_US").

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTheme(theme)`

Define um tema na planilha.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
// The code below sets the second predefined theme as the current theme of the spreadsheet.
var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes();
spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);

Parâmetros

Nome	Tipo	Descrição
`theme`	`SpreadsheetTheme`	O tema a ser aplicado.

Retornar

SpreadsheetTheme: o novo tema atual.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`setSpreadsheetTimeZone(timezone)`

Define o fuso horário da planilha.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Sets the time zone of the spreadsheet.
ss.setSpreadsheetTimeZone('America/New_York');

// Gets the time zone of the spreadsheet.
const ssTimeZone = ss.getSpreadsheetTimeZone();

// Logs the time zone to the console.
console.log(ssTimeZone);

Parâmetros

Nome	Tipo	Descrição
`timezone`	`String`	O fuso horário, especificado no formato "longo" (por exemplo, "America/New_York", conforme listado em Joda.org).

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`show(userInterface)`

Mostra um componente de interface do usuário personalizado em uma caixa de diálogo centralizada na viewport do navegador do usuário. A execução do script do lado do servidor não é suspensa. Para se comunicar com o lado do servidor, o componente da interface do usuário precisa fazer callbacks assíncronos para o script do lado do servidor.

Se o script do lado do servidor exibiu anteriormente uma caixa de diálogo que ainda não foi dispensada, a caixa de diálogo existente será substituída pela interface do usuário da caixa de diálogo recém-solicitada.

O snippet de código a seguir mostra uma aplicação HtmlService simples em uma caixa de diálogo com o título, a altura e a largura especificados:

var htmlApp = HtmlService
    .createHtmlOutput('<p>A change of speed, a change of style...</p>')
    .setTitle('My HtmlService Application')
    .setWidth(250)
    .setHeight(300);

SpreadsheetApp.getActiveSpreadsheet().show(htmlApp);

// The script resumes execution immediately after showing the dialog.

Parâmetros

Nome	Tipo	Descrição
`userInterface`	`Object`	Um `HtmlOutput`.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/script.container.ui

`sort(columnPosition)`

Classifica uma página por coluna, em ordem crescente.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, ascending
sheet.sort(1);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A coluna a ser classificada.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`sort(columnPosition, ascending)`

Ordena uma página por coluna. Recebe um parâmetro para especificar crescente ou decrescente.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// Sorts the sheet by the first column, descending
sheet.sort(1, false);

Parâmetros

Nome	Tipo	Descrição
`columnPosition`	`Integer`	A coluna a ser classificada.
`ascending`	`Boolean`	`true` para ordenações crescentes e `false` para decrescentes.

Retornar

Sheet: a planilha, útil para encadeamento de métodos

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg)`

Mostra uma janela pop-up no canto inferior direito da planilha com a mensagem.

// Show a popup with the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started');

Parâmetros

Nome	Tipo	Descrição
`msg`	`String`	A mensagem que será mostrada no aviso.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title)`

Mostra uma janela pop-up no canto inferior direito da planilha com a mensagem e o título fornecidos.

// Show a popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');

Parâmetros

Nome	Tipo	Descrição
`msg`	`String`	A mensagem que será mostrada no aviso.
`title`	`String`	O título opcional do aviso.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`toast(msg, title, timeoutSeconds)`

Mostra uma janela pop-up no canto inferior direito da planilha com o título e a mensagem fornecidos, que permanecem visíveis por um determinado período.

// Show a 3-second popup with the title "Status" and the message "Task started".
SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);

Parâmetros

Nome	Tipo	Descrição
`msg`	`String`	A mensagem que será mostrada no aviso.
`title`	`String`	O título opcional do aviso.
`timeoutSeconds`	`Number`	O tempo limite em segundos. Se `null`, o padrão é de 5 segundos. Se for negativo, o aviso permanece até ser dispensado.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideColumn(column)`

Mostra a coluna no intervalo especificado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first column if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideColumn(range);

Parâmetros

Nome	Tipo	Descrição
`column`	`Range`	O intervalo a ser mostrado, se estiver oculto.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`unhideRow(row)`

Mostra a linha no intervalo especificado.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This unhides the first row if it was previously hidden
var range = sheet.getRange("A1");
sheet.unhideRow(range);

Parâmetros

Nome	Tipo	Descrição
`row`	`Range`	O intervalo a ser mostrado, se estiver oculto.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`updateMenu(name, subMenus)`

Atualiza um menu adicionado por addMenu(name, subMenus). Funciona exatamente como addMenu(name, subMenus).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var menuEntries = [];
menuEntries.push({name: "Lone Menu Entry", functionName: "function1"});
ss.updateMenu("addMenuExample", menuEntries);

Parâmetros

Nome	Tipo	Descrição
`name`	`String`	O nome do menu a ser atualizado.
`subMenus`	`Object[]`	Uma matriz de mapas JavaScript com parâmetros `name` e `functionName`. É possível usar funções de bibliotecas incluídas, como `Library.libFunction1`.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`waitForAllDataExecutionsCompletion(timeoutInSeconds)`

Aguarda até que todas as execuções atuais na planilha sejam concluídas, com um tempo limite após o número de segundos fornecido. Gera uma exceção se as execuções não forem concluídas quando o tempo expirar, mas não cancela as execuções de dados.

Parâmetros

Nome	Tipo	Descrição
`timeoutInSeconds`	`Integer`	O tempo de espera para execuções de dados, em segundos. O máximo é 300 segundos.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Métodos obsoletos

`getSheetProtection()`

Obsoleto. Para planilhas criadas na versão mais recente das Planilhas Google, use Sheet.getProtections(type), que retorna a classe Protection mais poderosa. Embora esse método tenha sido descontinuado, ele ainda está disponível para oferecer compatibilidade com a versão mais antiga das Planilhas

Retorna uma instância PageProtection que descreve as permissões da planilha atual.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

permissions.setProtected(true);
permissions.addUser("user@example.com");

// Logs the users that have access to edit this sheet. Note that this
// is different from access to the entire spreadsheet - getUsers()
// only returns users if permissions.isProtected() is set to true.
var users = permissions.getUsers();
Logger.log(users);

Retornar

PageProtection: um objeto que descreve as permissões de acesso à planilha.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

`isAnonymousView()`

Obsoleto. Desde janeiro de 2014, essa função foi descontinuada e não está disponível na nova versão das Planilhas Google.

Indica se o documento permite visualização anônima. Como esse recurso não é mais compatível com a nova versão das Planilhas Google, use File.getSharingAccess() e File.getSharingPermission().

// Determine if the document allows anonymous viewing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission != DriveApp.Permission.NONE;

Retornar

Boolean: true se o documento permitir a visualização anônima, false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Consulte também

Serviço do Drive

`isAnonymousWrite()`

Obsoleto. Desde janeiro de 2014, essa função foi descontinuada e não está disponível na nova versão das Planilhas Google.

Indica se o documento permite edições de usuários anônimos. Como isso não é mais compatível com a nova versão das Planilhas Google, use File.getSharingAccess() e File.getSharingPermission().

// Determine if the document allow anonymous edits via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());
var access = file.getSharingAccess();
var permission = file.getSharingPermission();
var isAnonymousAccess =
    access == DriveApp.Access.ANYONE || access == DriveApp.Access.ANYONE_WITH_LINK;
var isAnonymousEdit = isAnonymousAccess && permission == DriveApp.Permission.EDIT;

Retornar

Boolean: true se o documento permitir a edição anônima, false caso contrário.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Consulte também

Serviço do Drive

`setAnonymousAccess(anonymousReadAllowed, anonymousWriteAllowed)`

Obsoleto. Desde janeiro de 2014, essa função foi descontinuada e não está disponível na nova versão das Planilhas Google.

Define a política do documento para leitura e gravação anônimas. Como esse recurso não é mais compatível com a nova versão das Planilhas Google, use File.setSharing(accessType, permissionType) como alternativa.

// Set the document's policy on anonymous reading and writing via the Drive API.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var file = DriveApp.getFileById(ss.getId());

// Set anonymous read.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.VIEW);

// Set anonymous write.
file.setSharing(DriveApi.Access.ANYONE, DriveApi.Permission.EDIT);

// Disable anonymous access.
file.setSharing(DriveApi.Access.PRIVATE, file.getSharingPermission());

Parâmetros

Nome	Tipo	Descrição
`anonymousReadAllowed`	`Boolean`	`true` para permitir leituras anônimas. Caso contrário, `false`.
`anonymousWriteAllowed`	`Boolean`	`true` para permitir leituras anônimas. Caso contrário, `false`.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets

Consulte também

isAnonymousView()
isAnonymousWrite()
Serviço do Drive

`setSheetProtection(permissions)`

Obsoleto. Para planilhas criadas na versão mais recente das Planilhas Google, use Sheet.protect(), que retorna a classe Protection mais poderosa. Embora esse método tenha sido descontinuado, ele ainda está disponível para compatibilidade com a versão mais antiga das Planilhas.

Define as permissões da planilha atual.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var permissions = sheet.getSheetProtection();

// This copies the permissions on the first sheet to the second sheet
var sheetToClonePermissionsTo = ss.getSheets()[1];
sheetToClonePermissionsTo.setSheetProtection(permissions);

Parâmetros

Nome	Tipo	Descrição
`permissions`	`PageProtection`	O objeto de permissões de acesso a ser definido nesta página.

Autorização

Os scripts que usam esse método exigem autorização com um ou mais dos seguintes escopos:

https://www.googleapis.com/auth/spreadsheets.currentonly
https://www.googleapis.com/auth/spreadsheets