Halaman ini diterjemahkan oleh Cloud Translation API.

Class SpreadsheetApp

Mengakses dan membuat file Google Spreadsheet. Class ini adalah class induk untuk layanan Spreadsheet.

Properti

Properti	Jenis	Deskripsi
`AutoFillSeries`	`AutoFillSeries`	Enumerasi jenis deret yang digunakan untuk menghitung nilai yang diisi otomatis.
`BandingTheme`	`BandingTheme`	Enumerasi kemungkinan tema banding.
`BooleanCriteria`	`BooleanCriteria`	Enumerasi kriteria boolean pemformatan bersyarat.
`BorderStyle`	`BorderStyle`	Enumerasi gaya yang valid untuk menetapkan batas pada `Range`.
`ColorType`	`ColorType`	Enumerasi kemungkinan jenis warna.
`CopyPasteType`	`CopyPasteType`	Enumerasi kemungkinan jenis tempel.
`DataExecutionErrorCode`	`DataExecutionErrorCode`	Enumerasi kemungkinan kode error eksekusi data.
`DataExecutionState`	`DataExecutionState`	Enumerasi kemungkinan status eksekusi data.
`DataSourceParameterType`	`DataSourceParameterType`	Enumerasi kemungkinan jenis parameter sumber data.
`DataSourceRefreshScope`	`DataSourceRefreshScope`	Enumerasi kemungkinan cakupan pembaruan sumber data.
`DataSourceType`	`DataSourceType`	Enumerasi kemungkinan jenis sumber data.
`DataValidationCriteria`	`DataValidationCriteria`	Enumerasi yang mewakili kriteria validasi data yang dapat ditetapkan pada rentang.
`DateTimeGroupingRuleType`	`DateTimeGroupingRuleType`	Enumerasi aturan pengelompokan tanggal dan waktu.
`DeveloperMetadataLocationType`	`DeveloperMetadataLocationType`	Enumerasi kemungkinan jenis lokasi metadata developer.
`DeveloperMetadataVisibility`	`DeveloperMetadataVisibility`	Enumerasi kemungkinan visibilitas metadata developer.
`Dimension`	`Dimension`	Enumerasi kemungkinan dimensi spreadsheet.
`Direction`	`Direction`	Enumerasi kemungkinan arah yang dapat dipindahkan dalam spreadsheet menggunakan tombol panah.
`FrequencyType`	`FrequencyType`	Enumerasi kemungkinan jenis frekuensi.
`GroupControlTogglePosition`	`GroupControlTogglePosition`	Enumerasi posisi yang dapat digunakan tombol kontrol grup.
`InterpolationType`	`InterpolationType`	Enumerasi jenis interpolasi gradien format bersyarat.
`PivotTableSummarizeFunction`	`PivotTableSummarizeFunction`	Enumerasi fungsi yang dapat digunakan untuk meringkas nilai dalam tabel pivot.
`PivotValueDisplayType`	`PivotValueDisplayType`	Enumerasi cara nilai pivot dapat ditampilkan.
`ProtectionType`	`ProtectionType`	Enumerasi yang mewakili bagian spreadsheet yang dapat dilindungi dari pengeditan.
`RecalculationInterval`	`RecalculationInterval`	Enumerasi kemungkinan interval yang dapat digunakan dalam penghitungan ulang spreadsheet.
`RelativeDate`	`RelativeDate`	Enumerasi opsi tanggal relatif untuk menghitung nilai yang akan digunakan dalam `BooleanCriteria` berbasis tanggal.
`SheetType`	`SheetType`	Enumerasi berbagai jenis sheet yang dapat ada dalam spreadsheet.
`SortOrder`	`SortOrder`	Enumerasi urutan pengurutan.
`TextDirection`	`TextDirection`	Enumerasi petunjuk teks yang valid.
`TextToColumnsDelimiter`	`TextToColumnsDelimiter`	Enumerasi pemisah preset untuk memisahkan teks ke kolom.
`ThemeColorType`	`ThemeColorType`	Enumerasi kemungkinan jenis warna tema.
`ValueType`	`ValueType`	Enumerasi jenis nilai yang ditampilkan oleh `Range.getValue()` dan `Range.getValues()` dari class Rentang layanan Spreadsheet. Nilai enumerasi yang tercantum di bawah ini adalah tambahan dari `Number`, `Boolean`, `Date`, atau `String`.
`WrapStrategy`	`WrapStrategy`	Enumerasi strategi yang digunakan untuk menggabungkan sel.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`create(name)`	`Spreadsheet`	Membuat spreadsheet baru dengan nama yang diberikan.
`create(name, rows, columns)`	`Spreadsheet`	Membuat spreadsheet baru dengan nama yang diberikan dan jumlah baris dan kolom yang ditentukan.
`enableAllDataSourcesExecution()`	`void`	Mengaktifkan eksekusi data untuk semua jenis sumber data.
`enableBigQueryExecution()`	`void`	Mengaktifkan eksekusi data untuk sumber data BigQuery.
`enableLookerExecution()`	`void`	Mengaktifkan eksekusi data untuk sumber data Looker.
`flush()`	`void`	Menerapkan semua perubahan Spreadsheet yang tertunda.
`getActive()`	`Spreadsheet`	Menampilkan spreadsheet yang saat ini aktif, atau `null` jika tidak ada.
`getActiveRange()`	`Range`	Menampilkan rentang yang dipilih di sheet aktif, atau `null` jika tidak ada rentang aktif.
`getActiveRangeList()`	`RangeList`	Menampilkan daftar rentang aktif di sheet aktif atau `null` jika tidak ada rentang yang dipilih.
`getActiveSheet()`	`Sheet`	Mendapatkan sheet aktif dalam spreadsheet.
`getActiveSpreadsheet()`	`Spreadsheet`	Menampilkan spreadsheet yang saat ini aktif, atau `null` jika tidak ada.
`getCurrentCell()`	`Range`	Menampilkan sel saat ini (yang ditandai) yang dipilih di salah satu rentang aktif di sheet aktif atau `null` jika tidak ada sel saat ini.
`getSelection()`	`Selection`	Menampilkan `Selection` saat ini di spreadsheet.
`getUi()`	`Ui`	Menampilkan instance lingkungan antarmuka pengguna spreadsheet yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan sidebar.
`newCellImage()`	`CellImageBuilder`	Membuat builder untuk `CellImage`.
`newColor()`	`ColorBuilder`	Membuat builder untuk `Color`.
`newConditionalFormatRule()`	`ConditionalFormatRuleBuilder`	Membuat builder untuk aturan format bersyarat.
`newDataSourceSpec()`	`DataSourceSpecBuilder`	Membuat builder untuk `DataSourceSpec`.
`newDataValidation()`	`DataValidationBuilder`	Membuat builder untuk aturan validasi data.
`newFilterCriteria()`	`FilterCriteriaBuilder`	Membuat builder untuk `FilterCriteria`.
`newRichTextValue()`	`RichTextValueBuilder`	Membuat builder untuk nilai Teks Kaya.
`newTextStyle()`	`TextStyleBuilder`	Membuat builder untuk gaya teks.
`open(file)`	`Spreadsheet`	Membuka spreadsheet yang sesuai dengan objek File yang diberikan.
`openById(id)`	`Spreadsheet`	Membuka spreadsheet dengan ID yang diberikan.
`openByUrl(url)`	`Spreadsheet`	Membuka spreadsheet dengan URL yang diberikan.
`setActiveRange(range)`	`Range`	Menetapkan rentang yang ditentukan sebagai `active range`, dengan sel kiri atas dalam rentang sebagai `current cell`.
`setActiveRangeList(rangeList)`	`RangeList`	Menetapkan daftar rentang yang ditentukan sebagai `active ranges`.
`setActiveSheet(sheet)`	`Sheet`	Menetapkan sheet aktif dalam spreadsheet.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	Menetapkan sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut.
`setActiveSpreadsheet(newActiveSpreadsheet)`	`void`	Menetapkan spreadsheet aktif.
`setCurrentCell(cell)`	`Range`	Menetapkan sel yang ditentukan sebagai `current cell`.

Dokumentasi mendetail

`create(name)`

Membuat spreadsheet baru dengan nama yang diberikan.

// The code below creates a new spreadsheet "Finances" and logs the URL for it
const ssNew = SpreadsheetApp.create('Finances');
Logger.log(ssNew.getUrl());

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama untuk spreadsheet.

Pulang pergi

Spreadsheet — spreadsheet baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`create(name, rows, columns)`

Membuat spreadsheet baru dengan nama yang diberikan dan jumlah baris dan kolom yang ditentukan.

// The code below creates a new spreadsheet "Finances" with 50 rows and 5
// columns and logs the URL for it
const ssNew = SpreadsheetApp.create('Finances', 50, 5);
Logger.log(ssNew.getUrl());

Parameter

Nama	Jenis	Deskripsi
`name`	`String`	Nama untuk spreadsheet.
`rows`	`Integer`	Jumlah baris untuk spreadsheet.
`columns`	`Integer`	Jumlah kolom untuk spreadsheet.

Pulang pergi

Spreadsheet — spreadsheet baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`enableAllDataSourcesExecution()`

Mengaktifkan eksekusi data untuk semua jenis sumber data.

Eksekusi data akan menampilkan pengecualian jika jenis sumber data tidak diaktifkan. Gunakan metode ini untuk mengaktifkan eksekusi data bagi semua jenis sumber data.

// Turns data execution on for all types of data sources.
SpreadsheetApp.enableAllDataSourcesExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the data.
ss.getDataSourceSheets()[0].refreshData();

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/bigquery.readonly

`enableBigQueryExecution()`

Mengaktifkan eksekusi data untuk sumber data BigQuery.

Eksekusi data untuk sumber data BigQuery akan menampilkan pengecualian jika tidak diaktifkan.

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

// 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 the first data source sheet in the spreadsheet and refreshes the
// BigQuery data.
ss.getDataSourceSheets()[0].refreshData();

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

https://www.googleapis.com/auth/bigquery.readonly

`enableLookerExecution()`

Mengaktifkan eksekusi data untuk sumber data Looker.

Eksekusi data untuk sumber data Looker akan menampilkan pengecualian jika tidak diaktifkan.

// Turns data execution on for Looker data sources.
SpreadsheetApp.enableLookerExecution();

// 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 the first data source sheet in the spreadsheet and refreshes the
// associated Looker data.
ss.getDataSourceSheets()[0].refreshData();

`flush()`

Menerapkan semua perubahan Spreadsheet yang tertunda.

Operasi spreadsheet terkadang digabungkan untuk meningkatkan performa, seperti saat melakukan beberapa panggilan ke Range.getValue(). Namun, terkadang Anda mungkin ingin memastikan bahwa semua perubahan yang tertunda segera dilakukan, misalnya untuk menampilkan data pengguna saat skrip dieksekusi.

// The code below changes the background color of cells A1 and B1 twenty times.
// You should be able to see the updates live in the spreadsheet. If flush() is
// not called, the updates may be applied live or may all be applied at once
// when the script completes.
function colors() {
  const sheet = SpreadsheetApp.getActiveSheet();
  for (let i = 0; i < 20; i++) {
    if (i % 2 === 0) {
      sheet.getRange('A1').setBackground('green');
      sheet.getRange('B1').setBackground('red');
    } else {
      sheet.getRange('A1').setBackground('red');
      sheet.getRange('B1').setBackground('green');
    }
    SpreadsheetApp.flush();
  }
}

`getActive()`

Menampilkan spreadsheet yang saat ini aktif, atau null jika tidak ada.

Fungsi yang dijalankan dalam konteks spreadsheet dapat mendapatkan referensi ke objek Spreadsheet yang sesuai dengan memanggil fungsi ini.

// The code below logs the URL for the active spreadsheet.
Logger.log(SpreadsheetApp.getActive().getUrl());

Pulang pergi

Spreadsheet — objek Spreadsheet yang aktif

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveRange()`

Menampilkan rentang yang dipilih di sheet aktif, atau null jika tidak ada rentang aktif. Jika beberapa rentang dipilih, metode ini hanya menampilkan rentang terakhir yang dipilih.

Ini biasanya berarti rentang yang telah dipilih pengguna di sheet aktif, tetapi dalam fungsi kustom, ini merujuk pada sel yang dihitung ulang secara aktif.

// The code below logs the background color for the active range.
const colorObject = SpreadsheetApp.getActiveRange().getBackgroundObject();
// Assume the color has ColorType.RGB.
Logger.log(colorObject.asRgbColor().asHexString());

Pulang pergi

Range — Rentang aktif.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveRangeList()`

Menampilkan daftar rentang aktif di sheet aktif atau null jika tidak ada rentang yang dipilih. Rentang aktif yang berisi sel yang ditandai saat ini ditempatkan terakhir dalam daftar.

Jika ada satu rentang yang dipilih, perilakunya akan sama seperti panggilan getActiveRange().

// Returns the list of active ranges.
const rangeList = SpreadsheetApp.getActiveRangeList();

Pulang pergi

RangeList — daftar rentang aktif

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveSheet()`

Mendapatkan sheet aktif dalam spreadsheet.

Sheet aktif dalam spreadsheet adalah sheet yang ditampilkan di UI spreadsheet.

// The code below logs the name of the active sheet.
Logger.log(SpreadsheetApp.getActiveSheet().getName());

Pulang pergi

Sheet — objek Sheet yang aktif

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getActiveSpreadsheet()`

Menampilkan spreadsheet yang saat ini aktif, atau null jika tidak ada.

Fungsi yang dijalankan dalam konteks spreadsheet dapat mendapatkan referensi ke objek Spreadsheet yang sesuai dengan memanggil fungsi ini.

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

Pulang pergi

Spreadsheet — objek Spreadsheet yang aktif

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getCurrentCell()`

Menampilkan sel saat ini (yang ditandai) yang dipilih di salah satu rentang aktif di sheet aktif atau null jika tidak ada sel saat ini.

// Returns the current highlighted cell in the one of the active ranges.
const currentCell = SpreadsheetApp.getCurrentCell();

Pulang pergi

Range — sel saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getSelection()`

Menampilkan Selection saat ini di spreadsheet.

const selection = SpreadsheetApp.getSelection();
const currentCell = selection.getCurrentCell();

Pulang pergi

Selection — pilihan saat ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`getUi()`

Menampilkan instance lingkungan antarmuka pengguna spreadsheet yang memungkinkan skrip untuk menambahkan fitur seperti menu, dialog, dan sidebar. Skrip hanya dapat berinteraksi dengan UI untuk instance spreadsheet terbuka saat ini, dan hanya jika skrip terikat ke spreadsheet. Untuk informasi selengkapnya, lihat panduan untuk menu serta dialog dan sidebar.

// Add a custom menu to the active spreadsheet, including a separator and a
// sub-menu.
function onOpen(e) {
  SpreadsheetApp.getUi()
      .createMenu('My Menu')
      .addItem('My menu item', 'myFunction')
      .addSeparator()
      .addSubMenu(
          SpreadsheetApp.getUi()
              .createMenu('My sub-menu')
              .addItem('One sub-menu item', 'mySecondFunction')
              .addItem('Another sub-menu item', 'myThirdFunction'),
          )
      .addToUi();
}

Pulang pergi

Ui — instance lingkungan antarmuka pengguna spreadsheet ini

`newCellImage()`

Membuat builder untuk CellImage.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 on Sheet1.
const range = sheet.getRange('A1');

// Builds an image using a source URL.
const cellImage =
    SpreadsheetApp.newCellImage()
        .setSourceUrl(
            'https://www.gstatic.com/images/branding/productlogos/apps_script/v10/web-64dp/logo_apps_script_color_1x_web_64dp.png',
            )
        .build();

// Sets the image in cell A1.
range.setValue(cellImage);

Pulang pergi

CellImageBuilder — Builder baru.

`newColor()`

Membuat builder untuk Color.

const rgbColor = SpreadsheetApp.newColor().setRgbColor('#FF0000').build();

Pulang pergi

ColorBuilder — Builder baru.

`newConditionalFormatRule()`

Membuat builder untuk aturan format bersyarat.

// Adds a conditional format rule to a sheet that causes all cells in range
// A1:B3 to turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActive().getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Pulang pergi

ConditionalFormatRuleBuilder — builder baru.

`newDataSourceSpec()`

Membuat builder untuk DataSourceSpec.

// 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',
);

// Enables BigQuery.
SpreadsheetApp.enableBigQueryExecution();

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

Pulang pergi

DataSourceSpecBuilder — Builder baru.

`newDataValidation()`

Membuat builder untuk aturan validasi data.

const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = SpreadsheetApp.newDataValidation()
                 .requireNumberBetween(1, 100)
                 .setAllowInvalid(false)
                 .setHelpText('Number must be between 1 and 100.')
                 .build();
cell.setDataValidation(rule);

Pulang pergi

DataValidationBuilder — Builder baru.

`newFilterCriteria()`

Membuat builder untuk FilterCriteria.

// 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 Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets the range to A1:D20.
const range = sheet.getRange('A1:D20');

// Creates a filter and applies it to the specified range.
range.createFilter();

// Gets the current filter for the range and creates filter criteria that only
// shows cells that aren't empty.
const filter = range.getFilter();
const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();

// Sets the criteria to  column C.
filter.setColumnFilterCriteria(3, criteria);

Pulang pergi

FilterCriteriaBuilder — builder baru

`newRichTextValue()`

Membuat builder untuk nilai Teks Kaya.

// Sets cell A1 to have the text "Hello world", with "Hello" bolded.
const cell = SpreadsheetApp.getActive().getRange('A1');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const value = SpreadsheetApp.newRichTextValue()
                  .setText('Hello world')
                  .setTextStyle(0, 5, bold)
                  .build();
cell.setRichTextValue(value);

Pulang pergi

RichTextValueBuilder — Builder baru.

`newTextStyle()`

Membuat builder untuk gaya teks.

// Sets range A1:B3 to have red, size 22, bolded, underlined text.
const range = SpreadsheetApp.getActive().getRange('A1:B3');
const style = SpreadsheetApp.newTextStyle()
                  .setForegroundColor('red')
                  .setFontSize(22)
                  .setBold(true)
                  .setUnderline(true)
                  .build();
range.setTextStyle(style);

Pulang pergi

TextStyleBuilder — Builder baru.

`open(file)`

Membuka spreadsheet yang sesuai dengan objek File yang diberikan.

// Get any starred spreadsheets from Google Drive, then open the spreadsheets
// and log the name of the first sheet within each spreadsheet.
const files = DriveApp.searchFiles(
    `starred = true and mimeType = "${MimeType.GOOGLE_SHEETS}"`,
);
while (files.hasNext()) {
  const spreadsheet = SpreadsheetApp.open(files.next());
  const sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

Parameter

Nama	Jenis	Deskripsi
`file`	`File`	File yang akan dibuka.

Pulang pergi

Spreadsheet — spreadsheet

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`openById(id)`

Membuka spreadsheet dengan ID yang diberikan. ID spreadsheet dapat diekstrak dari URL-nya. Misalnya, ID spreadsheet di URL https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 adalah "abc1234567".

// The code below opens a spreadsheet using its ID and logs the name for it.
// Note that the spreadsheet is NOT physically opened on the client side.
// It is opened on the server only (for modification by the script).
const ss = SpreadsheetApp.openById('abc1234567');
Logger.log(ss.getName());

Parameter

Nama	Jenis	Deskripsi
`id`	`String`	ID unik untuk spreadsheet.

Pulang pergi

Spreadsheet — objek Spreadsheet dengan ID yang diberikan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`openByUrl(url)`

Membuka spreadsheet dengan URL yang diberikan. Menampilkan pengecualian skrip jika URL tidak ada atau pengguna tidak memiliki izin untuk mengaksesnya.

// Opens a spreadsheet by its URL and logs its name.
// Note that the spreadsheet doesn't physically open on the client side.
// It opens on the server only (for modification by the script).
const ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit',
);
console.log(ss.getName());

Parameter

Nama	Jenis	Deskripsi
`url`	`String`	URL untuk spreadsheet.

Pulang pergi

Spreadsheet — Objek spreadsheet dengan URL yang diberikan.

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setActiveRange(range)`

Menetapkan rentang yang ditentukan sebagai active range, dengan sel kiri atas dalam rentang sebagai current cell.

UI spreadsheet menampilkan sheet yang berisi rentang yang dipilih dan memilih sel yang ditentukan dalam rentang yang dipilih.

// The code below sets range C1:D4 in the first sheet as the active range.
const range =
    SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('C1:D4');
SpreadsheetApp.setActiveRange(range);

const selection = SpreadsheetApp.getSelection();
// Current cell: C1
const currentCell = selection.getCurrentCell();
// Active Range: C1:D4
const activeRange = selection.getActiveRange();

Parameter

Nama	Jenis	Deskripsi
`range`	`Range`	Rentang yang akan dijadikan rentang aktif.

Pulang pergi

Range — Rentang aktif baru

`setActiveRangeList(rangeList)`

Menetapkan daftar rentang yang ditentukan sebagai active ranges. Rentang terakhir dalam daftar ditetapkan sebagai active range.

// The code below sets ranges [D4, B2:C4] in the active sheet as the active
// ranges.
const rangeList = SpreadsheetApp.getActiveSheet().getRanges(['D4', 'B2:C4']);
SpreadsheetApp.setActiveRangeList(rangeList);

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

Parameter

Nama	Jenis	Deskripsi
`rangeList`	`RangeList`	Daftar rentang yang akan dipilih.

Pulang pergi

RangeList — daftar rentang yang baru dipilih

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setActiveSheet(sheet)`

Menetapkan sheet aktif dalam spreadsheet. UI Google Spreadsheet menampilkan sheet yang dipilih kecuali jika sheet tersebut termasuk dalam spreadsheet lain.

// The code below makes the 2nd sheet active in the active spreadsheet.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
SpreadsheetApp.setActiveSheet(spreadsheet.getSheets()[1]);

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet aktif baru.

Pulang pergi

Sheet — sheet yang telah dijadikan sheet aktif baru

`setActiveSheet(sheet, restoreSelection)`

Menetapkan sheet aktif dalam spreadsheet, dengan opsi untuk memulihkan pilihan terbaru dalam sheet tersebut. UI Google Spreadsheet menampilkan sheet yang dipilih, kecuali jika sheet tersebut milik spreadsheet yang berbeda.

const spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
const firstSheet = spreadsheet.getSheets()[0];
const 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
const range = spreadsheet.getActiveSheet().getSelection().getActiveRange();
Logger.log(range.getA1Notation());

Parameter

Nama	Jenis	Deskripsi
`sheet`	`Sheet`	Sheet aktif baru.
`restoreSelection`	`Boolean`	Jika `true`, pemilihan terbaru dari sheet aktif baru akan dipilih lagi saat sheet baru menjadi aktif; jika `false`, sheet baru akan aktif tanpa mengubah pilihan saat ini.

Pulang pergi

Sheet — sheet aktif baru

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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

`setActiveSpreadsheet(newActiveSpreadsheet)`

Menetapkan spreadsheet aktif.

// The code below makes the spreadsheet with key "1234567890" the active
// spreadsheet
const ss = SpreadsheetApp.openById('1234567890');
SpreadsheetApp.setActiveSpreadsheet(ss);

Parameter

Nama	Jenis	Deskripsi
`newActiveSpreadsheet`	`Spreadsheet`	Spreadsheet yang akan dijadikan spreadsheet aktif.

`setCurrentCell(cell)`

Menetapkan sel yang ditentukan sebagai current cell.

Jika sel yang ditentukan ada dalam rentang yang sudah dipilih, rentang tersebut akan menjadi rentang aktif dengan sel sebagai sel saat ini.

Jika sel yang ditentukan tidak ada dalam rentang yang dipilih, pemilihan yang ada akan dihapus dan sel menjadi sel saat ini dan rentang aktif.

Catatan:Range yang ditentukan harus terdiri dari satu sel. Jika tidak, metode ini akan menampilkan pengecualian.

// The code below sets the cell B5 in the first sheet as the current cell.
const cell =
    SpreadsheetApp.getActiveSpreadsheet().getSheets()[0].getRange('B5');
SpreadsheetApp.setCurrentCell(cell);

const selection = SpreadsheetApp.getSelection();
// Current cell: B5
const currentCell = selection.getCurrentCell();

Parameter

Nama	Jenis	Deskripsi
`cell`	`Range`	Sel yang akan ditetapkan sebagai sel saat ini.

Pulang pergi

Range — sel saat ini yang baru ditetapkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

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