getSheetById

function getSheetById(
  sheetId: number,
  ss?: GoogleAppsScript.Spreadsheet.Spreadsheet | undefined | null
): GoogleAppsScript.Spreadsheet.Sheet | null;

Ідентифікатор переживає перейменування та перестановку — саме тому його й варто зберігати у властивостях чи конфігурації. В Apps Script немає пошуку за ідентифікатором, тому аркуші перебираються та порівнюються.

Таблиця типово — активна. Відсутній аркуш дає null, а не виняток: збережений ідентифікатор, який більше не знаходиться, — це випадок для обробки, а не падіння.

Параметри

Параметр	Тип	Опис
`sheetId`	`number`	Шуканий ідентифікатор аркуша.
`ss` (необов'язковий)	`GoogleAppsScript.Spreadsheet.Spreadsheet \\| undefined \\| null`	Таблиця, у якій шукати. Типово активна.

Повертає

GoogleAppsScript.Spreadsheet.Sheet | null — аркуш або null, якщо такого ідентифікатора немає.

Приклади

Пошук

const sheet = getSheetById(0);

if (sheet === null) {
  throw new Error("That sheet is gone.");
}

Дивіться також

Вихідний код

src/appsscript/sheet/getSheetById.ts

23 September 2026

Цю документацію згенеровано нейромережею (Claude) на основі вихідного коду бібліотеки.