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
Özellik | Tür | Açıklama |
---|---|---|
AutoFillSeries | AutoFillSeries | Otomatik doldurulan değerleri hesaplamak için kullanılan seri türlerinin numaralandırması. |
BandingTheme | BandingTheme | Olası şerit oluşturma temalarının listesi. |
BooleanCriteria | BooleanCriteria | Koşullu biçimlendirme boole ölçütlerinin listesi. |
BorderStyle | BorderStyle | Range üzerinde kenarlık ayarlamak için geçerli stillerin numaralandırması. |
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 sıralaması. |
DataSourceParameterType | DataSourceParameterType | Olası veri kaynağı parametre türlerinin listesi. |
DataSourceRefreshScope | DataSourceRefreshScope | Olası veri kaynağı yenileme kapsamlarının sıralaması. |
DataSourceType | DataSourceType | Olası veri kaynağı türlerinin listesi. |
DataValidationCriteria | DataValidationCriteria | Bir aralıkta ayarlanabilecek veri doğrulama ölçütlerini temsil eden numaralandırma. |
DateTimeGroupingRuleType | DateTimeGroupingRuleType | Tarih saat gruplandırma kuralının numaralandırması. |
DeveloperMetadataLocationType | DeveloperMetadataLocationType | Olası geliştirici meta verisi konum türlerinin listesi. |
DeveloperMetadataVisibility | DeveloperMetadataVisibility | Olası geliştirici meta veri görünürlüklerinin listesi. |
Dimension | Dimension | Bir e-tablonun olası boyutlarının numaralandırması. |
Direction | Direction | Bir kişinin e-tablo içinde oku kullanarak hareket edebileceği olası yönlerinin numaralandırması tuşlarını kullanın. |
FrequencyType | FrequencyType | Olası sıklık türlerinin listesi. |
GroupControlTogglePosition | GroupControlTogglePosition | Grup denetimini açma/kapatma düğmesinin içinde olabileceği konumların numaralandırması. |
InterpolationType | InterpolationType | Koşullu biçimli gradyan interpolasyon türlerinin listesi. |
PivotTableSummarizeFunction | PivotTableSummarizeFunction | Pivot tablodaki değerleri özetlemek için kullanılabilecek işlevlerin numaralandırması. |
PivotValueDisplayType | PivotValueDisplayType | Bir pivot değerinin gösterilebileceği yöntemlerin listesi. |
ProtectionType | ProtectionType | E-tablonun düzenlemelere karşı korunabilecek bölümlerini temsil eden bir numaralandırma. |
RecalculationInterval | RecalculationInterval | E-tabloda yeniden hesaplamada kullanılabilecek olası aralıkların numaralandırması. |
RelativeDate | RelativeDate | Tarih tabanlı BooleanCriteria öğesinde kullanılacak değeri hesaplamak için göreli tarih seçeneklerinin sıralaması. |
SheetType | SheetType | Bir e-tabloda yer alabilecek farklı sayfa türlerinin listesi. |
SortOrder | SortOrder | Sıralama ölçütünün numaralandırması. |
TextDirection | TextDirection | Geçerli metin yönlerinin sıralaması. |
TextToColumnsDelimiter | TextToColumnsDelimiter | Metni sütunlara bölmek için önceden ayarlanmış sınırlayıcıların numaralandırması. |
ThemeColorType | ThemeColorType | Olası tema renk türlerinin listesi. |
ValueType | ValueType | E-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. |
WrapStrategy | WrapStrategy | Hücreleri sarmalamak için kullanılan stratejilerin numaralandırması. |
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
create(name) | Spreadsheet | Belirtilen adla yeni bir e-tablo oluşturur. |
create(name, rows, columns) | Spreadsheet | Verilen ada ve belirtilen sayıda satır ve sütuna sahip yeni bir e-tablo oluşturur. |
enableAllDataSourcesExecution() | void | Veri yürütme özelliğini tüm veri kaynağı türleri için etkinleştirir. |
enableBigQueryExecution() | void | BigQuery veri kaynakları için veri yürütme özelliğini etkinleştirir. |
flush() | void | Beklemedeki tüm E-tablo değişikliklerini uygular. |
getActive() | Spreadsheet | O anda etkin olan e-tabloyu veya e-tablo yoksa null değerini döndürür. |
getActiveRange() | Range | Etkin sayfada 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 veya aralık yoksa null döndürür.
seçili. |
getActiveSheet() | Sheet | E-tablodaki etkin sayfayı alır. |
getActiveSpreadsheet() | Spreadsheet | O 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() | Selection | E-tablodaki geçerli Selection değerini döndürür. |
getUi() | Ui | E-tablonun, komut dosyasının aşağıdaki işlemleri yapmasına olanak tanıyan 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() | 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 oluşturucu oluşturur. |
newDataSourceSpec() | DataSourceSpecBuilder | DataSourceSpec için bir oluşturucu oluşturur. |
newDataValidation() | DataValidationBuilder | Veri doğrulama kuralı için 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 Dosya nesnesine karşılık gelen e-tabloyu açar. |
openById(id) | Spreadsheet | Verilen kimliğe sahip e-tabloyu açar. |
openByUrl(url) | Spreadsheet | Verilen URL'yi içeren e-tabloyu açar. |
setActiveRange(range) | Range | Belirtilen aralığı, en üstteki active range olacak şekilde ayarlar
current cell olarak aralıktaki sol hücreyi seçin. |
setActiveRangeList(rangeList) | RangeList | Belirtilen aralık listesini active ranges olarak ayarlar. |
setActiveSheet(sheet) | Sheet | E-tablodaki etkin sayfayı ayarlar. |
setActiveSheet(sheet, restoreSelection) | Sheet | Bir e-tablodaki etkin sayfayı ayarlar (en son seçimi geri yükleme seçeneği ile birlikte) bu sayfada yer alır. |
setActiveSpreadsheet(newActiveSpreadsheet) | void | Etkin e-tabloyu ayarlar. |
setCurrentCell(cell) | Range | Belirtilen 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
Ad | Tür | Açıklama |
---|---|---|
name | String | E-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
Ad | Tür | Açıklama |
---|---|---|
name | String | E-tablonun adı. |
rows | Integer | E-tablodaki satır sayısı. |
columns | Integer | E-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
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, listede en sona 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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
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 Dosya 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
Ad | Tür | Açıklama |
---|---|---|
file | File | Açı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
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ı, 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
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Belirtilen aralığı, en üstteki active range
olacak şekilde ayarlar
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
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin 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
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ı, 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
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Yeni etkin sayfa. |
Return
Sheet
: Yeni etkin sayfa yapılan 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ü, bir sayfaya ait değilse seçili sayfayı 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
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Yeni etkin sayfa. |
restoreSelection | Boolean | true 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
Ad | Tür | Açıklama |
---|---|---|
newActiveSpreadsheet | Spreadsheet | Etkin 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
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ı, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets