Class NamedRange

Intervalonomeado

Crie, acesse e modifique intervalos nomeados em uma planilha. Os intervalos nomeados são intervalos que têm alcuns tipos de string associados. Elas podem ser visualizadas e editadas na interface das Planilhas no menu Dados > Intervalos nomeados....

Métodos

Método	Tipo de retorno	Breve descrição
getName()	String	Extrai o nome desse intervalo nomeado.
getRange()	Range	Encontra o intervalo referenciado por este intervalo nomeado.
remove()	void	Exclui este intervalo nomeado.
setName(name)	NamedRange	Define/atualiza o nome do intervalo nomeado.
setRange(range)	NamedRange	Define/atualiza o intervalo para esse intervalo nomeado.

Documentação detalhada

getName()

Extrai o nome desse intervalo nomeado.

Retornar

String: o nome do intervalo nomeado.

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()

Encontra o intervalo referenciado por este intervalo nomeado.

Retornar

Range: o intervalo da planilha associado a esse intervalo nomeado

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

---

remove()

Exclui este intervalo nomeado.

// The code below deletes all the named ranges in the spreadsheet.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let i = 0; i < namedRanges.length; i++) {
  namedRanges[i].remove();
}

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

---

setName(name)

Define/atualiza o nome do intervalo nomeado.

// The code below updates the name for the first named range.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parâmetros

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

Retornar

NamedRange: o intervalo cujo nome foi definido pela chamada

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

---

setRange(range)

Define/atualiza o intervalo para esse intervalo nomeado.

Parâmetros

Nome	Tipo	Descrição
range	Range	O intervalo da planilha a ser associado a este intervalo nomeado.

Retornar

NamedRange: o intervalo nomeado para o qual o intervalo da planilha foi definido.

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