Class NamedRange

名前付き範囲

スプレッドシートで名前付き範囲を作成、アクセス、変更します。名前付き範囲は、文字列エイリアスが関連付けられている範囲です。名前付き範囲は、スプレッドシートの UI の [データ] > [名前付き範囲] メニューで表示、編集できます。

メソッド

メソッド	戻り値の型	概要
getName()	String	この名前付き範囲の名前を取得します。
getRange()	Range	この名前付き範囲が参照する範囲を取得します。
remove()	void	この名前付き範囲を削除します。
setName(name)	NamedRange	名前付き範囲の名前を設定または更新します。
setRange(range)	NamedRange	この名前付き範囲の範囲を設定または更新します。

詳細なドキュメント

getName()

この名前付き範囲の名前を取得します。

戻る

String - この名前付き範囲の名前

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

---

getRange()

この名前付き範囲が参照する範囲を取得します。

戻る

Range - この名前付き範囲に関連付けられているスプレッドシート範囲

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

---

remove()

この名前付き範囲を削除します。

// 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();
}

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

---

setName(name)

名前付き範囲の名前を設定または更新します。

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

パラメータ

名前	型	説明
name	String	名前付き範囲の新しい名前。

戻る

NamedRange - 呼び出しによって名前が設定された範囲

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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

---

setRange(range)

この名前付き範囲の範囲を設定または更新します。

パラメータ

名前	型	説明
range	Range	この名前付き範囲に関連付けるスプレッドシート範囲。

戻る

NamedRange - スプレッドシートの範囲が設定されている名前付き範囲

承認

このメソッドを使用するスクリプトには、次のスコープの 1 つ以上による承認が必要です。

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