Class SpreadsheetApp

SpreadsheetApp

Google E-Tablolar dosyalarına erişebilir ve dosya oluşturabilirsiniz. Bu sınıf, E-tablo hizmetinin üst sınıfıdır.

Özellikler

ÖzellikTürAçıklama
AutoFillSeriesAutoFillSeriesOtomatik doldurulan değerleri hesaplamak için kullanılan seri türlerinin listesi.
BandingThemeBandingThemeOlası şerit oluşturma temalarının listesi.
BooleanCriteriaBooleanCriteriaKoşullu biçimlendirme boole ölçütlerinin listesi.
BorderStyleBorderStyleRange üzerinde kenarlık ayarlamak için geçerli stillerin numaralandırması.
ColorTypeColorTypeOlası renk türlerinin listesi.
CopyPasteTypeCopyPasteTypeOlası yapıştırma türlerinin listesi.
DataExecutionErrorCodeDataExecutionErrorCodeOlası veri yürütme hata kodlarının listesi.
DataExecutionStateDataExecutionStateOlası veri yürütme durumlarının sıralaması.
DataSourceParameterTypeDataSourceParameterTypeOlası veri kaynağı parametre türlerinin listesi.
DataSourceRefreshScopeDataSourceRefreshScopeOlası veri kaynağı yenileme kapsamlarının listesi.
DataSourceTypeDataSourceTypeOlası veri kaynağı türlerinin listesi.
DataValidationCriteriaDataValidationCriteriaBir aralıkta ayarlanabilecek veri doğrulama ölçütlerini temsil eden numaralandırma.
DateTimeGroupingRuleTypeDateTimeGroupingRuleTypeTarih saat gruplandırma kuralının numaralandırması.
DeveloperMetadataLocationTypeDeveloperMetadataLocationTypeOlası geliştirici meta verisi konum türlerinin listesi.
DeveloperMetadataVisibilityDeveloperMetadataVisibilityOlası geliştirici meta veri görünürlüklerinin listesi.
DimensionDimensionBir e-tablonun olası boyutlarının numaralandırması.
DirectionDirectionBir kişinin e-tablo içinde oku kullanarak hareket edebileceği olası yönlerinin numaralandırması tuşlarını kullanın.
FrequencyTypeFrequencyTypeOlası sıklık türlerinin listesi.
GroupControlTogglePositionGroupControlTogglePositionGrup denetimini açma/kapatma düğmesinin içinde olabileceği konumların numaralandırması.
InterpolationTypeInterpolationTypeKoşullu biçimli gradyan interpolasyon türlerinin listesi.
PivotTableSummarizeFunctionPivotTableSummarizeFunctionPivot tablodaki değerleri özetlemek için kullanılabilecek işlevlerin numaralandırması.
PivotValueDisplayTypePivotValueDisplayTypeBir pivot değerinin gösterilebileceği yöntemlerin listesi.
ProtectionTypeProtectionTypeE-tablonun düzenlemelere karşı korunabilecek bölümlerini temsil eden bir numaralandırma.
RecalculationIntervalRecalculationIntervalE-tabloda yeniden hesaplamada kullanılabilecek olası aralıkların numaralandırması.
RelativeDateRelativeDateTarih tabanlı BooleanCriteria öğesinde kullanılacak değeri hesaplamak için göreli tarih seçeneklerinin sıralaması.
SheetTypeSheetTypeBir e-tabloda yer alabilecek farklı sayfa türlerinin listesi.
SortOrderSortOrderSıralama ölçütünün numaralandırması.
TextDirectionTextDirectionGeçerli metin yönlerinin sıralaması.
TextToColumnsDelimiterTextToColumnsDelimiterMetni sütunlara bölmek için önceden ayarlanmış sınırlayıcıların numaralandırması.
ThemeColorTypeThemeColorTypeOlası tema renk türlerinin listesi.
ValueTypeValueTypeE-tablo hizmetinin Aralık sınıfından Range.getValue() ve Range.getValues() tarafından döndürülen değer türlerinin listesi. Numaralandırma değerleri Number, Boolean, Date veya String'e ek olarak aşağıda listelenenler listelenmiştir.
WrapStrategyWrapStrategyHücreleri sarmalamak için kullanılan stratejilerin numaralandırması.

Yöntemler

YöntemDönüş türüKısa açıklama
create(name)SpreadsheetBelirtilen adla yeni bir e-tablo oluşturur.
create(name, rows, columns)SpreadsheetVerilen ada ve belirtilen sayıda satır ve sütuna sahip yeni bir e-tablo oluşturur.
enableAllDataSourcesExecution()voidTüm veri kaynağı türleri için veri yürütmeyi etkinleştirir.
enableBigQueryExecution()voidBigQuery veri kaynakları için veri yürütme özelliğini etkinleştirir.
enableLookerExecution()voidLooker veri kaynakları için veri yürütme özelliğini etkinleştirir.
flush()voidBeklemedeki tüm e-tablo değişikliklerini uygular.
getActive()SpreadsheetO anda etkin olan e-tabloyu veya e-tablo yoksa null değerini döndürür.
getActiveRange()RangeEtkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür.
getActiveRangeList()RangeListEtkin sayfadaki etkin aralıkların listesini veya aralık yoksa null döndürür. seçili.
getActiveSheet()SheetE-tablodaki etkin sayfayı alır.
getActiveSpreadsheet()SpreadsheetO anda etkin olan e-tabloyu veya e-tablo yoksa null değerini döndürür.
getCurrentCell()RangeŞuradaki etkin aralıklardan birinde seçilmiş olan geçerli (vurgulanan) hücreyi etkin sayfayı veya geçerli hücre yoksa null.
getSelection()SelectionE-tablodaki geçerli Selection değerini döndürür.
getUi()UiE-tablonun, komut dosyasının aşağıdaki işlemleri yapmasına izin veren kullanıcı arayüzü ortamının bir örneğini döndürür: Menü, iletişim kutusu ve kenar çubuğu gibi özellikler ekleyin.
newCellImage()CellImageBuilderCellImage için bir oluşturucu oluşturur.
newColor()ColorBuilderColor için bir oluşturucu oluşturur.
newConditionalFormatRule()ConditionalFormatRuleBuilderKoşullu biçimlendirme kuralı için oluşturucu oluşturur.
newDataSourceSpec()DataSourceSpecBuilderDataSourceSpec için bir oluşturucu oluşturur.
newDataValidation()DataValidationBuilderVeri doğrulama kuralı için oluşturucu oluşturur.
newFilterCriteria()FilterCriteriaBuilderFilterCriteria için bir oluşturucu oluşturur.
newRichTextValue()RichTextValueBuilderZengin Metin değeri için bir oluşturucu oluşturur.
newTextStyle()TextStyleBuilderMetin stili için bir oluşturucu oluşturur.
open(file)SpreadsheetBelirtilen Dosya nesnesine karşılık gelen e-tabloyu açar.
openById(id)SpreadsheetVerilen kimliğe sahip e-tabloyu açar.
openByUrl(url)SpreadsheetVerilen URL'yi içeren e-tabloyu açar.
setActiveRange(range)RangeBelirtilen aralığı active range olarak ayarlar ve üst current cell olarak aralıktaki sol hücreyi seçin.
setActiveRangeList(rangeList)RangeListBelirtilen aralık listesini active ranges olarak ayarlar.
setActiveSheet(sheet)SheetE-tablodaki etkin sayfayı ayarlar.
setActiveSheet(sheet, restoreSelection)SheetBir e-tablodaki etkin sayfayı ayarlar (en son seçimi geri yükleme seçeneği ile birlikte) bu sayfada yer alır.
setActiveSpreadsheet(newActiveSpreadsheet)voidEtkin e-tabloyu ayarlar.
setCurrentCell(cell)RangeBelirtilen hücreyi current cell olarak ayarlar.

Ayrıntılı belgeler

create(name)

Belirtilen adla yeni bir e-tablo oluşturur.

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

Parametreler

AdTürAçıklama
nameStringE-tablonun adı.

Return

Spreadsheet — yeni bir e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

create(name, rows, columns)

Verilen 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
var ssNew = SpreadsheetApp.create("Finances", 50, 5);
Logger.log(ssNew.getUrl());

Parametreler

AdTürAçıklama
nameStringE-tablonun adı.
rowsIntegerE-tablodaki satır sayısı.
columnsIntegerE-tablonun sütun sayısı.

Return

Spreadsheet — yeni bir e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

enableAllDataSourcesExecution()

Veri yürütme özelliğini tüm veri kaynağı türleri için etkinleştirir.

Veri kaynağı türü etkin değilse veri yürütme işlemi istisna oluşturur. Bu yöntemi kullan seçeneğini tıklayarak veri yürütme özelliğini tüm veri kaynağı türleri için etkinleştirin.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

enableBigQueryExecution()

BigQuery veri kaynakları için veri yürütme özelliğini etkinleştirir.

BigQuery veri kaynağı için veri yürütme özelliği etkinleştirilmezse istisna oluşur.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

enableLookerExecution()

Looker veri kaynakları için veri yürütme özelliğini etkinleştirir.

Looker veri kaynağı için veri yürütme özelliği etkinleştirilmezse istisna uygulanı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 gruplanır (örneğin, birden fazla çağrı yapmaktır. Ancak bazen tüm bunların beklemedeki değişiklikler hemen yapılır (örneğin, bir komut dosyası çalışırken kullanıcı verilerini 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() {
  var sheet = SpreadsheetApp.getActiveSheet();
  for (var 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()

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

Bir e-tablo bağlamında çalıştırılan işlevler ilgili E-tablo nesnesini tanımlayın.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getActiveRange()

Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. Eğer birden çok aralık seçilir. Bu yöntem yalnızca en son seçilen aralığı döndürür.

Bu genellikle, bir kullanıcının etkin sayfada seçtiği aralık anlamına gelir fakat özel bir sayfada işlevini ifade eder.

// The code below logs the background color for the active range.
var 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getActiveRangeList()

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

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

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

Return

RangeList — etkin aralıkların listesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getActiveSheet()

E-tablodaki etkin sayfayı alır.

Bir e-tablodaki etkin sayfa, o e-tabloda görüntülenmekte olan sayfadır. Kullanıcı arayüzü.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getActiveSpreadsheet()

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

Bir e-tablo bağlamında çalıştırılan işlevler karşılık gelen Spreadsheet nesnesini ifade eder.

// 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

getCurrentCell()

Şuradaki etkin aralıklardan birinde seçilmiş olan geçerli (vurgulanan) hücreyi etkin sayfayı veya geçerli hücre yoksa null.

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

Return

Range — geçerli hücre

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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.

var selection = SpreadsheetApp.getSelection();
var 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, komut dosyasının aşağıdaki işlemleri yapmasına izin veren kullanıcı arayüzü ortamının bir örneğini döndürür: Menü, iletişim kutusu ve kenar çubuğu gibi özellikler ekleyin. Bir komut dosyası yalnızca açık bir e-tablonun geçerli örneğini ve yalnızca komut dosyası e-tabloya bağlıysa. Daha fazla bilgi için bkz. menüler, iletişim kutuları ve kenar çubukları kılavuzları.

// 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.

var rgbColor = SpreadsheetApp.newColor().setRgbColor("#FF0000").build();

Return

ColorBuilder — Yeni oluşturucu.


newConditionalFormatRule()

Koşullu biçimlendirme kuralı için 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.
var sheet = SpreadsheetApp.getActive().getActiveSheet();
var range = sheet.getRange('A1:B3');
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build()
var 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 oluşturucu oluşturur.

var cell = SpreadsheetApp.getActive().getRange('A1');
var 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.
var cell = SpreadsheetApp.getActive().getRange('A1');
var bold = SpreadsheetApp.newTextStyle().setBold(true).build();
var 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.
var range = SpreadsheetApp.getActive().getRange('A1:B3');
var 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.
var files = DriveApp.searchFiles(
    'starred = true and mimeType = "' + MimeType.GOOGLE_SHEETS + '"');
while (files.hasNext()) {
  var spreadsheet = SpreadsheetApp.open(files.next());
  var sheet = spreadsheet.getSheets()[0];
  Logger.log(sheet.getName());
}

Parametreler

AdTürAçıklama
fileFileAçılacak dosya.

Return

Spreadsheet — e-tablo

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

openById(id)

Verilen kimliğe sahip e-tabloyu açar. E-tablo kimliği, e-tablonun URL'sinden çıkarılabilir. Örneğin, Ö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).
var ss = SpreadsheetApp.openById("abc1234567");
Logger.log(ss.getName());

Parametreler

AdTürAçıklama
idStringE-tablonun benzersiz tanımlayıcısı.

Return

Spreadsheet — belirtilen kimliğe sahip E-tablo nesnesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

openByUrl(url)

Verilen URL'yi içeren e-tabloyu açar. URL yoksa komut dosyası istisnası atar veya kullanıcının erişim izni yoktur.

// 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).
var ss = SpreadsheetApp.openByUrl(
    'https://docs.google.com/spreadsheets/d/abc1234567/edit');
console.log(ss.getName());

Parametreler

AdTürAçıklama
urlStringE-tablonun URL'si.

Return

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

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setActiveRange(range)

Belirtilen aralığı active range olarak ayarlar ve üst current cell olarak aralıktaki sol hücreyi seçin.

E-tablonun kullanıcı arayüzünde, seçilen aralığı içeren sayfa görüntüleniyor ve hücreleri seçiliyor. belirlenen aralık dahilindedir.

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

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

Parametreler

AdTürAçıklama
rangeRangeEtkin aralık olacak aralık.

Return

Range - yeni etkin Aralık


setActiveRangeList(rangeList)

Belirtilen aralık listesini active ranges olarak ayarlar. Son listedeki aralık active range olarak ayarlanır.

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

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

Parametreler

AdTürAçıklama
rangeListRangeListSeçilecek aralıkların listesi.

Return

RangeList: Yeni seçilen aralık listesi

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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

setActiveSheet(sheet)

E-tablodaki etkin sayfayı ayarlar. Google E-Tablolar kullanıcı arayüzünde, sayfa farklı bir e-tabloya aittir.

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

Parametreler

AdTürAçıklama
sheetSheetYeni etkin sayfa.

Return

Sheet: Yeni etkin sayfa olarak oluşturulan sayfa


setActiveSheet(sheet, restoreSelection)

Bir e-tablodaki etkin sayfayı ayarlar (en son seçimi geri yükleme seçeneği ile birlikte) bu sayfada yer alır. Google E-Tablolar kullanıcı arayüzü, sayfa bir farklı bir e-tablo oluşturabilirsiniz.

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

Parametreler

AdTürAçıklama
sheetSheetYeni etkin sayfa.
restoreSelectionBooleantrue ise yeni etkin sayfanın en son seçimi yeni sayfa etkin hale geldiğinde tekrar seçili hale gelir; 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

  • 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
var ss = SpreadsheetApp.openById("1234567890");
SpreadsheetApp.setActiveSpreadsheet(ss);

Parametreler

AdTürAçıklama
newActiveSpreadsheetSpreadsheetEtkin e-tablo yapılacak e-tablo.

setCurrentCell(cell)

Belirtilen hücreyi current cell olarak ayarlar.

Belirtilen hücre önceden seçilmiş bir aralıkta yer alıyorsa bu aralık hücrenin geçerli hücre olduğu etkin aralık.

Belirtilen hücre seçilen aralıklarda bulunmuyorsa mevcut seçim kaldırılır ve hücre, geçerli hücre ve etkin aralık olur.

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

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

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

Parametreler

AdTürAçıklama
cellRangeGeçerli hücre olarak ayarlanacak hücre.

Return

Range: Yeni ayarlanan geçerli hücre

Yetkilendirme

Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:

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