Bu sayfa, Cloud Translation API ile çevrilmiştir.

Class SpreadsheetApp

Google E-Tablolar dosyalarına erişebilir ve dosya oluşturabilir. Bu sınıf, E-Tablolar hizmeti için üst sınıftır.

Özellikler

Mülk	Tür	Açıklama
`AutoFillSeries`	`AutoFillSeries`	Otomatik doldurulmuş değerleri hesaplamak için kullanılan seri türlerinin listesi.
`BandingTheme`	`BandingTheme`	Olası bant temalarının listesi.
`BooleanCriteria`	`BooleanCriteria`	Koşullu biçimlendirme boole ölçütlerinin bir listesi.
`BorderStyle`	`BorderStyle`	`Range`'te kenarlık ayarlamak için geçerli stillerin listesi.
`ColorType`	`ColorType`	Olası renk türlerinin listesi.
`CopyPasteType`	`CopyPasteType`	Olası yapıştırma türlerinin listesi.
`DataExecutionErrorCode`	`DataExecutionErrorCode`	Olası veri yürütme hata kodlarının listesi.
`DataExecutionState`	`DataExecutionState`	Olası veri yürütme durumlarının listesi.
`DataSourceParameterType`	`DataSourceParameterType`	Olası veri kaynağı parametresi türlerinin listesi.
`DataSourceRefreshScope`	`DataSourceRefreshScope`	Olası veri kaynağı yenileme kapsamlarının bir listesi.
`DataSourceType`	`DataSourceType`	Olası veri kaynağı türlerinin listesi.
`DataValidationCriteria`	`DataValidationCriteria`	Bir aralık üzerinde ayarlanabilen veri doğrulama ölçütlerini temsil eden bir liste.
`DateTimeGroupingRuleType`	`DateTimeGroupingRuleType`	Tarih saat gruplandırma kuralının bir dizili listesi.
`DeveloperMetadataLocationType`	`DeveloperMetadataLocationType`	Olası geliştirici meta verisi konum türlerinin listesi.
`DeveloperMetadataVisibility`	`DeveloperMetadataVisibility`	Olası geliştirici meta verisi görünürlüklerinin listesi.
`Dimension`	`Dimension`	Bir e-tablonun olası boyutlarının listesi.
`Direction`	`Direction`	Ok tuşlarını kullanarak e-tabloda hareket edebileceğiniz olası yönlerin listesi.
`FrequencyType`	`FrequencyType`	Olası sıklık türlerinin listesi.
`GroupControlTogglePosition`	`GroupControlTogglePosition`	Grup kontrol düğmesinin bulunabileceği konumların listesi.
`InterpolationType`	`InterpolationType`	Koşullu biçimlendirme gradyan enterpolasyon türlerinin bir listesi.
`PivotTableSummarizeFunction`	`PivotTableSummarizeFunction`	Pivot tablodaki değerleri özetlemek için kullanılabilecek işlevlerin listesi.
`PivotValueDisplayType`	`PivotValueDisplayType`	Bir pivot değerinin gösterilebileceği yolların listesi.
`ProtectionType`	`ProtectionType`	Bir e-tablonun düzenlemeye karşı korunabilecek bölümlerini temsil eden bir liste.
`RecalculationInterval`	`RecalculationInterval`	E-tabloyu yeniden hesaplarken kullanılabilecek olası aralıkların listesi.
`RelativeDate`	`RelativeDate`	Tarihe dayalı `BooleanCriteria` işlevinde kullanılacak bir değeri hesaplamak için göreli tarih seçeneklerinin bir listesi.
`SheetType`	`SheetType`	Bir e-tabloda bulunabilecek farklı e-tablo türlerinin listesi.
`SortOrder`	`SortOrder`	Sıralama düzeninin bir dizilişi.
`TextDirection`	`TextDirection`	Geçerli metin yönergelerinin listesi.
`TextToColumnsDelimiter`	`TextToColumnsDelimiter`	Metni sütunlara bölme işlemi için önceden ayarlanmış sınırlayıcıların listesi.
`ThemeColorType`	`ThemeColorType`	Olası tema rengi türlerinin listesi.
`ValueType`	`ValueType`	E-Tablolar hizmetinin Range sınıfından `Range.getValue()` ve `Range.getValues()` tarafından döndürülen değer türlerinin bir listesi. Aşağıda listelenen numaralandırma değerleri, `Number`, `Boolean`, `Date` veya `String`'a ek olarak kullanılır.
`WrapStrategy`	`WrapStrategy`	Hücreleri sarmalamak için kullanılan stratejilerin bir listesi.

Yöntemler

Yöntem	Dönüş türü	Kısa açıklama
`create(name)`	`Spreadsheet`	Belirtilen ada sahip yeni bir e-tablo oluşturur.
`create(name, rows, columns)`	`Spreadsheet`	Belirtilen ada ve belirtilen sayıda satır ve sütuna sahip yeni bir e-tablo oluşturur.
`enableAllDataSourcesExecution()`	`void`	Tüm veri kaynağı türleri için veri yürütmeyi etkinleştirir.
`enableBigQueryExecution()`	`void`	BigQuery veri kaynakları için veri yürütmeyi etkinleştirir.
`enableLookerExecution()`	`void`	Looker veri kaynakları için veri yürütme işlemini etkinleştirir.
`flush()`	`void`	Beklemedeki tüm e-tablo değişikliklerini uygular.
`getActive()`	`Spreadsheet`	Şu anda etkin e-tabloyu veya e-tablo yoksa `null` değerini döndürür.
`getActiveRange()`	`Range`	Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa `null` değerini döndürür.
`getActiveRangeList()`	`RangeList`	Etkin sayfadaki etkin aralıkların listesini döndürür veya seçili aralık yoksa `null` değerini döndürür.
`getActiveSheet()`	`Sheet`	E-tablodaki etkin sayfayı alır.
`getActiveSpreadsheet()`	`Spreadsheet`	Şu anda etkin e-tabloyu veya e-tablo yoksa `null` değerini döndürür.
`getCurrentCell()`	`Range`	Etkin sayfadaki etkin aralıklardan birinde seçili olan geçerli (vurgulanmış) hücreyi döndürür veya geçerli hücre yoksa `null` değerini döndürür.
`getSelection()`	`Selection`	E-tablodaki geçerli `Selection` değerini döndürür.
`getUi()`	`Ui`	E-tablonun kullanıcı arayüzü ortamının bir örneğini döndürür. Bu örnek, komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine olanak tanır.
`newCellImage()`	`CellImageBuilder`	`CellImage` için bir oluşturucu oluşturur.
`newColor()`	`ColorBuilder`	`Color` için bir oluşturucu oluşturur.
`newConditionalFormatRule()`	`ConditionalFormatRuleBuilder`	Koşullu biçimlendirme kuralı için bir oluşturucu oluşturur.
`newDataSourceSpec()`	`DataSourceSpecBuilder`	`DataSourceSpec` için bir oluşturucu oluşturur.
`newDataValidation()`	`DataValidationBuilder`	Veri doğrulama kuralı için bir oluşturucu oluşturur.
`newFilterCriteria()`	`FilterCriteriaBuilder`	`FilterCriteria` için bir oluşturucu oluşturur.
`newRichTextValue()`	`RichTextValueBuilder`	Zengin metin değeri için bir oluşturucu oluşturur.
`newTextStyle()`	`TextStyleBuilder`	Metin stili için bir oluşturucu oluşturur.
`open(file)`	`Spreadsheet`	Belirtilen File nesnesine karşılık gelen e-tabloyu açar.
`openById(id)`	`Spreadsheet`	Belirtilen kimliğe sahip e-tabloyu açar.
`openByUrl(url)`	`Spreadsheet`	Belirtilen URL'ye sahip e-tabloyu açar.
`setActiveRange(range)`	`Range`	Belirtilen aralığı `active range` olarak, aralığın sol üst hücresini ise `current cell` olarak ayarlar.
`setActiveRangeList(rangeList)`	`RangeList`	Belirtilen aralık listesini `active ranges` olarak ayarlar.
`setActiveSheet(sheet)`	`Sheet`	E-tabloda etkin sayfayı ayarlar.
`setActiveSheet(sheet, restoreSelection)`	`Sheet`	E-tablodaki etkin sayfayı ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar.
`setActiveSpreadsheet(newActiveSpreadsheet)`	`void`	Etkin e-tabloyu ayarlar.
`setCurrentCell(cell)`	`Range`	Belirtilen hücreyi `current cell` olarak ayarlar.

Ayrıntılı dokümanlar

`create(name)`

Belirtilen ada sahip yeni bir e-tablo oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`name`	`String`	E-tablonun adı.

Return

Spreadsheet: Yeni bir e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`create(name, rows, columns)`

Belirtilen ada ve belirtilen sayıda satır ve sütuna sahip yeni bir e-tablo oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`name`	`String`	E-tablonun adı.
`rows`	`Integer`	E-tablonun satır sayısı.
`columns`	`Integer`	E-tablodaki sütun sayısı.

Return

Spreadsheet: Yeni bir e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`enableAllDataSourcesExecution()`

Tüm veri kaynağı türleri için veri yürütmeyi etkinleştirir.

Veri kaynağı türü etkin değilse veri yürütme işlemi bir istisna atar. Tüm veri kaynağı türleri için veri yürütme işlemini etkinleştirmek üzere bu yöntemi kullanın.

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`enableBigQueryExecution()`

BigQuery veri kaynakları için veri yürütmeyi etkinleştirir.

BigQuery veri kaynağı için veri yürütme etkinleştirilmezse istisna atılır.

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

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`enableLookerExecution()`

Looker veri kaynakları için veri yürütme işlemini etkinleştirir.

Looker veri kaynağı için veri yürütme etkinleştirilmezse istisna atılır.

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

Beklemedeki tüm e-tablo değişikliklerini uygular.

E-tablo işlemleri bazen performansı artırmak için birlikte gruplandırılır (ör. Range.getValue() işlevine birden çok kez çağrı yapıldığında). Ancak bazen, bekleyen tüm değişikliklerin hemen yapıldığından emin olmak isteyebilirsiniz (ör. komut dosyası yürütülürken kullanıcılara verileri göstermek için).

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

Şu anda etkin e-tabloyu veya e-tablo yoksa null değerini döndürür.

E-tablo bağlamında çalıştırılan işlevler, bu işlevi çağırarak ilgili E-tablo nesnesine referans alabilir.

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

Return

Spreadsheet: Etkin e-tablo nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getActiveRange()`

Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. Birden fazla aralık seçilirse bu yöntem yalnızca son seçilen aralığı döndürür.

Bu genellikle kullanıcının etkin sayfada seçtiği aralığı ifade eder ancak özel işlevlerde etkin olarak yeniden hesaplanan hücreyi ifade eder.

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

Return

Range: Etkin aralık.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getActiveRangeList()`

Etkin sayfadaki etkin aralıkların listesini döndürür veya seçili aralık yoksa null değerini döndürür. Vurgulanan mevcut hücreyi içeren etkin aralık, listenin sonuna yerleştirilir.

Tek bir aralık seçiliyse bu, getActiveRange() çağrısı gibi davranır.

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

Return

RangeList: Etkin aralıkların listesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getActiveSheet()`

E-tablodaki etkin sayfayı alır.

E-tablodaki etkin sayfa, e-tablo kullanıcı arayüzünde görüntülenen sayfadır.

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

Return

Sheet: Etkin E-Tablo nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getActiveSpreadsheet()`

Şu anda etkin e-tabloyu veya e-tablo yoksa null değerini döndürür.

E-tablo bağlamında çalıştırılan işlevler, bu işlevi çağırarak ilgili Spreadsheet nesnesine referans alabilir.

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

Return

Spreadsheet: Etkin e-tablo nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getCurrentCell()`

Etkin sayfadaki etkin aralıklardan birinde seçili olan geçerli (vurgulanmış) hücreyi döndürür veya geçerli hücre yoksa null değerini döndürür.

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

Return

Range: Geçerli hücre

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getSelection()`

E-tablodaki geçerli Selection değerini döndürür.

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

Return

Selection: Geçerli seçim

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`getUi()`

E-tablonun kullanıcı arayüzü ortamının bir örneğini döndürür. Bu örnek, komut dosyasının menü, iletişim kutusu ve kenar çubuğu gibi özellikler eklemesine olanak tanır. Bir komut dosyası, yalnızca açık e-tablonun mevcut örneğinin kullanıcı arayüzüyle etkileşime geçebilir ve yalnızca komut dosyası e-tabloya bağlıysa. Daha fazla bilgi için menüler ve iletişim kutuları ve kenar çubukları ile ilgili kılavuzları inceleyin.

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

Return

Ui: Bu e-tablonun kullanıcı arayüzü ortamının bir örneği

`newCellImage()`

CellImage için bir oluşturucu oluşturur.

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

Return

CellImageBuilder: Yeni oluşturucu.

`newColor()`

Color için bir oluşturucu oluşturur.

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

Return

ColorBuilder: Yeni oluşturucu.

`newConditionalFormatRule()`

Koşullu biçimlendirme kuralı için bir oluşturucu oluşturur.

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

Return

ConditionalFormatRuleBuilder: Yeni oluşturucu.

`newDataSourceSpec()`

DataSourceSpec için bir oluşturucu oluşturur.

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

Return

DataSourceSpecBuilder: Yeni oluşturucu.

`newDataValidation()`

Veri doğrulama kuralı için bir oluşturucu oluşturur.

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

Return

DataValidationBuilder: Yeni oluşturucu.

`newFilterCriteria()`

FilterCriteria için bir oluşturucu oluşturur.

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

Return

FilterCriteriaBuilder: Yeni oluşturucu

`newRichTextValue()`

Zengin metin değeri için bir oluşturucu oluşturur.

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

Return

RichTextValueBuilder: Yeni oluşturucu.

`newTextStyle()`

Metin stili için bir oluşturucu oluşturur.

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

Return

TextStyleBuilder: Yeni oluşturucu.

`open(file)`

Belirtilen File nesnesine karşılık gelen e-tabloyu açar.

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

Parametreler

Ad	Tür	Açıklama
`file`	`File`	Açılacak dosya.

Return

Spreadsheet: e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`openById(id)`

Belirtilen kimliğe sahip e-tabloyu açar. E-tablo kimliği, URL'sinden ayıklanabilir. Örneğin, https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 URL'sindeki e-tablo kimliği "abc1234567"dir.

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

Parametreler

Ad	Tür	Açıklama
`id`	`String`	E-tablonun benzersiz tanımlayıcısı.

Return

Spreadsheet: Belirtilen kimliğe sahip E-Tablo nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`openByUrl(url)`

Belirtilen URL'ye sahip e-tabloyu açar. URL mevcut değilse veya kullanıcının URL'ye erişme izni yoksa komut dosyası istisnası oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`url`	`String`	E-tablonun URL'si.

Return

Spreadsheet: Belirtilen URL'ye sahip e-tablo nesnesi.

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setActiveRange(range)`

Belirtilen aralığı active range olarak, aralığın sol üst hücresini ise current cell olarak ayarlar.

E-tablo kullanıcı arayüzü, seçilen aralığı içeren sayfayı gösterir ve seçilen aralıkta tanımlanan hücreleri seçer.

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

Parametreler

Ad	Tür	Açıklama
`range`	`Range`	Etkin aralık olarak ayarlanacak aralık.

Return

Range: yeni etkin aralık

`setActiveRangeList(rangeList)`

Belirtilen aralık listesini active ranges olarak ayarlar. Listede son aralık active range olarak ayarlanır.

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

Parametreler

Ad	Tür	Açıklama
`rangeList`	`RangeList`	Seçilecek aralıkların listesi.

Return

RangeList: Yeni seçilen aralık listesi

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setActiveSheet(sheet)`

E-tabloda etkin sayfayı ayarlar. Google E-Tablolar kullanıcı arayüzünde, farklı bir e-tabloya ait olmadığı sürece seçilen sayfa gösterilir.

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

Parametreler

Ad	Tür	Açıklama
`sheet`	`Sheet`	Yeni etkin sayfa.

Return

Sheet: Yeni etkin e-tablo haline getirilen e-tablo

`setActiveSheet(sheet, restoreSelection)`

E-tablodaki etkin sayfayı ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar. Google E-Tablolar kullanıcı arayüzünde, farklı bir e-tabloya ait olmadığı sürece seçilen sayfa gösterilir.

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

Parametreler

Ad	Tür	Açıklama
`sheet`	`Sheet`	Yeni etkin sayfa.
`restoreSelection`	`Boolean`	`true` ise yeni etkin sayfa etkin hale geldiğinde en son seçili öğe tekrar seçilir. `false` ise yeni sayfa, mevcut seçim değiştirilmeden etkin hale gelir.

Return

Sheet: Yeni etkin sayfa

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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

`setActiveSpreadsheet(newActiveSpreadsheet)`

Etkin e-tabloyu ayarlar.

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

Parametreler

Ad	Tür	Açıklama
`newActiveSpreadsheet`	`Spreadsheet`	Etkin e-tablo olacak e-tablo.

`setCurrentCell(cell)`

Belirtilen hücreyi current cell olarak ayarlar.

Belirtilen hücre zaten seçili bir aralıktaysa bu aralık, hücrenin geçerli hücre olduğu etkin aralık olur.

Belirtilen hücre, seçili bir aralıkta yoksa mevcut seçim kaldırılır ve hücre geçerli hücre ve etkin aralık olur.

Not: Belirtilen Range tek bir hücreden oluşmalıdır. Aksi takdirde bu yöntem bir istisna oluşturur.

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

Parametreler

Ad	Tür	Açıklama
`cell`	`Range`	Geçerli hücre olarak ayarlanacak hücre.

Return

Range: Yeni ayarlanan geçerli hücre

Yetkilendirme

Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:

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