Google E-Tablolar dosyalarına erişebilir ve bu dosyaları değiştirebilir. Genel işlemler, yeni e-tablolar eklemek ve ortak çalışanlar eklemektir.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
addDeveloperMetadata(key) | Spreadsheet | Belirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya ekler. |
addDeveloperMetadata(key, visibility) | Spreadsheet | Belirtilen anahtar ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler. |
addDeveloperMetadata(key, value) | Spreadsheet | Belirtilen anahtar ve değeri içeren geliştirici meta verilerini e-tabloya ekler. |
addDeveloperMetadata(key, value, visibility) | Spreadsheet | Belirtilen anahtar, değer ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler. |
addEditor(emailAddress) | Spreadsheet | Kullanıcıyı Spreadsheet düzenleyici listesine ekler. |
addEditor(user) | Spreadsheet | Kullanıcıyı Spreadsheet düzenleyici listesine ekler. |
addEditors(emailAddresses) | Spreadsheet | Belirtilen kullanıcı dizisini, Spreadsheet düzenleyicisi listesine ekler. |
addMenu(name, subMenus) | void | E-tablo kullanıcı arayüzünde yeni bir menü oluşturur. |
addViewer(emailAddress) | Spreadsheet | Kullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler. |
addViewer(user) | Spreadsheet | Kullanıcıyı Spreadsheet öğesini görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | Spreadsheet | Belirtilen kullanıcı dizisini, Spreadsheet için görüntüleyen listesine ekler. |
appendRow(rowContents) | Sheet | Sayfadaki geçerli veri bölgesinin en altına bir satır ekler. |
autoResizeColumn(columnPosition) | Sheet | Belirli bir sütunun genişliğini, içeriğine sığacak şekilde ayarlar. |
copy(name) | Spreadsheet | E-tabloyu kopyalar ve yeni e-tabloyu döndürür. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Bu e-tablonun kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür. |
createTextFinder(findText) | TextFinder | E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirmek için kullanılabilir. |
deleteActiveSheet() | Sheet | O anda etkin olan sayfayı siler. |
deleteColumn(columnPosition) | Sheet | Belirtilen sütun konumundaki sütunu siler. |
deleteColumns(columnPosition, howMany) | void | Belirtilen sütun konumundan başlayarak belirli bir sayıda sütunu siler. |
deleteRow(rowPosition) | Sheet | Belirtilen satır konumundaki satırı siler. |
deleteRows(rowPosition, howMany) | void | Belirtilen satır konumundan başlayan sayıda satırı siler. |
deleteSheet(sheet) | void | Belirtilen sayfayı siler. |
duplicateActiveSheet() | Sheet | Etkin sayfayı kopyalar ve etkin sayfa haline getirir. |
getActiveCell() | Range | Bu sayfadaki etkin hücreyi döndürür. |
getActiveRange() | Range | Etkin sayfada seçilen aralığı veya etkin aralık yoksa null değerini döndürür. |
getActiveRangeList() | RangeList | Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür. |
getActiveSheet() | Sheet | Bir e-tablodaki etkin sayfayı alır. |
getAs(contentType) | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. |
getBandings() | Banding[] | Bu e-tablodaki tüm bantları döndürür. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getColumnWidth(columnPosition) | Integer | Belirli bir sütunun genişliğini piksel olarak alır. |
getCurrentCell() | Range | Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür. |
getDataRange() | Range | Verilerin bulunduğu boyutlara karşılık gelen bir Range döndürür. |
getDataSourceFormulas() | DataSourceFormula[] | Tüm veri kaynağı formüllerini alır. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Tüm veri kaynağı pivot tablolarını alır. |
getDataSourceRefreshSchedules() | DataSourceRefreshSchedule[] | Bu e-tablonun yenileme programlarını alır. |
getDataSourceSheets() | DataSourceSheet[] | E-tablodaki tüm veri kaynağı sayfalarını döndürür. |
getDataSourceTables() | DataSourceTable[] | Tüm veri kaynağı tablolarını alır. |
getDataSources() | DataSource[] | E-tablodaki tüm veri kaynaklarını döndürür. |
getDeveloperMetadata() | DeveloperMetadata[] | Üst düzey e-tabloyla ilişkilendirilen geliştirici meta verilerini alır. |
getEditors() | User[] | Bu Spreadsheet için düzenleyenlerin listesini alır. |
getFormUrl() | String | Yanıtlarını bu e-tabloya gönderen formun URL'sini veya bu e-tablonun ilişkilendirilmiş bir formu yoksa null değerini döndürür. |
getFrozenColumns() | Integer | Dondurulmuş sütunların sayısını döndürür. |
getFrozenRows() | Integer | Dondurulmuş satırların sayısını döndürür. |
getId() | String | Bu e-tablo için benzersiz bir tanımlayıcı alır. |
getImages() | OverGridImage[] | Sayfadaki tüm ızgara içi resimleri döndürür. |
getIterativeCalculationConvergenceThreshold() | Number | Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. |
getLastColumn() | Integer | İçeriği olan son sütunun konumunu döndürür. |
getLastRow() | Integer | İçeriği olan son satırın konumunu döndürür. |
getMaxIterativeCalculationCycles() | Integer | Yinelemeli hesaplama sırasında kullanılacak maksimum yineleme sayısını döndürür. |
getName() | String | Belgenin adını alır. |
getNamedRanges() | NamedRange[] | Bu e-tablodaki tüm adlandırılmış aralıkları alır. |
getNumSheets() | Integer | Bu e-tablodaki sayfa sayısını döndürür. |
getOwner() | User | Dokümanın sahibini veya ortak Drive'daki bir doküman için null değerini döndürür. |
getPredefinedSpreadsheetThemes() | SpreadsheetTheme[] | Önceden tanımlanmış temaların listesini döndürür. |
getProtections(type) | Protection[] | E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne dizisini alır. |
getRange(a1Notation) | Range | Aralığı A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürür. |
getRangeByName(name) | Range | Adlandırılmış aralık veya belirtilen ada sahip herhangi bir aralık bulunmazsa null döndürür. |
getRangeList(a1Notations) | RangeList | Aynı sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür. |
getRecalculationInterval() | RecalculationInterval | Bu e-tabloya ilişkin hesaplama aralığını döndürür. |
getRowHeight(rowPosition) | Integer | Belirli bir satırın piksel cinsinden yüksekliğini alır. |
getSelection() | Selection | E-tablodaki geçerli Selection değerini döndürür. |
getSheetByName(name) | Sheet | Belirtilen ada sahip bir sayfa döndürür. |
getSheetId() | Integer | Bu nesnenin temsil ettiği sayfanın kimliğini döndürür. |
getSheetName() | String | Sayfa adını döndürür. |
getSheetValues(startRow, startColumn, numRows, numColumns) | Object[][] | Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. |
getSheets() | Sheet[] | Bu e-tablodaki tüm sayfaları alır. |
getSpreadsheetLocale() | String | E-tablo yerel ayarını alır. |
getSpreadsheetTheme() | SpreadsheetTheme | E-tablonun geçerli temasını veya herhangi bir tema uygulanmazsa null değerini döndürür. |
getSpreadsheetTimeZone() | String | E-tablonun saat dilimini alır. |
getUrl() | String | Belirli e-tablonun URL'sini döndürür. |
getViewers() | User[] | Bu Spreadsheet için görüntüleyenlerin ve yorum yapanların listesini alır. |
hideColumn(column) | void | Belirli bir aralıktaki sütunu veya sütunları gizler. |
hideRow(row) | void | Verilen aralıktaki satırları gizler. |
insertColumnAfter(afterPosition) | Sheet | Belirtilen sütun konumundan sonra bir sütun ekler. |
insertColumnBefore(beforePosition) | Sheet | Belirtilen sütun konumundan önce bir sütun ekler. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Belirtilen sütun konumundan sonra belirtilen sayıda sütun ekler. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Belirtilen sütun konumundan önce belirli sayıda sütun ekler. |
insertDataSourceSheet(spec) | DataSourceSheet | E-tabloya yeni bir DataSourceSheet ekler ve veri yürütme işlemini başlatır. |
insertImage(blobSource, column, row) | OverGridImage | Dokümanda belirli bir satır ve sütunda resim olarak bir Spreadsheet ekler. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Dokümanda belirli bir satır ve sütunda, piksel ofseti ile resim olarak Spreadsheet ekler. |
insertImage(url, column, row) | OverGridImage | Dokümana belirli bir satıra ve sütuna resim ekler. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Dokümanda belirli bir satır ve sütunda, piksel ofsetiyle bir resim ekler. |
insertRowAfter(afterPosition) | Sheet | Belirtilen satır konumundan sonra bir satır ekler. |
insertRowBefore(beforePosition) | Sheet | Belirtilen satır konumundan önce bir satır ekler. |
insertRowsAfter(afterPosition, howMany) | Sheet | Belirtilen satır konumundan sonraya belirli sayıda satır ekler. |
insertRowsBefore(beforePosition, howMany) | Sheet | Belirtilen satır konumundan önceye belirli sayıda satır ekler. |
insertSheet() | Sheet | Varsayılan sayfa adını kullanarak e-tabloya yeni bir sayfa ekler. |
insertSheet(sheetIndex) | Sheet | Belirtilen dizindeki e-tabloya yeni bir sayfa ekler. |
insertSheet(sheetIndex, options) | Sheet | Belirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. |
insertSheet(options) | Sheet | Varsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler. |
insertSheet(sheetName) | Sheet | E-tabloya belirtilen adla yeni bir sayfa ekler. |
insertSheet(sheetName, sheetIndex) | Sheet | E-tabloya, verilen dizinde belirtilen adla yeni bir sayfa ekler. |
insertSheet(sheetName, sheetIndex, options) | Sheet | E-tabloya, belirtilen dizinde belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. |
insertSheet(sheetName, options) | Sheet | E-tabloya belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. |
insertSheetWithDataSourceTable(spec) | Sheet | E-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir DataSourceTable oluşturur ve veri yürütme işlemini başlatır. |
isColumnHiddenByUser(columnPosition) | Boolean | Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
isIterativeCalculationEnabled() | Boolean | Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını döndürür. |
isRowHiddenByFilter(rowPosition) | Boolean | Belirli bir satırın bir filtre tarafından gizlenip gizlenmediğini döndürür (filtre görünümü değil). |
isRowHiddenByUser(rowPosition) | Boolean | Belirli bir satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
moveActiveSheet(pos) | void | Etkin sayfayı, sayfa listesinde belirli bir konuma taşır. |
moveChartToObjectSheet(chart) | Sheet | Yeni bir SheetType.OBJECT sayfası oluşturur ve sağlanan grafiği bu e-tabloya taşır. |
refreshAllDataSources() | void | Geçersiz veri kaynağı nesnelerini atlayarak desteklenen tüm veri kaynaklarını ve bunlara bağlı veri kaynağı nesnelerini yeniler. |
removeEditor(emailAddress) | Spreadsheet | Kullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır. |
removeEditor(user) | Spreadsheet | Kullanıcıyı, Spreadsheet düzenleyici listesinden kaldırır. |
removeMenu(name) | void | addMenu(name, subMenus) tarafından eklenen menüyü kaldırır. |
removeNamedRange(name) | void | Verilen ada sahip olan adlandırılmış bir aralığı siler. |
removeViewer(emailAddress) | Spreadsheet | İlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır. |
removeViewer(user) | Spreadsheet | İlgili kullanıcıyı, Spreadsheet için görüntüleyenler ve yorum yapanlar listesinden kaldırır. |
rename(newName) | void | Dokümanı yeniden adlandırır. |
renameActiveSheet(newName) | void | Geçerli etkin sayfayı verilen yeni adla yeniden adlandırır. |
resetSpreadsheetTheme() | SpreadsheetTheme | Uygulanan temayı kaldırır ve e-tablodaki varsayılan temayı ayarlar. |
setActiveRange(range) | Range | Belirtilen aralığı etkin sayfada active range olarak ayarlar ve aralıktaki sol üstteki hücre current cell olarak ayarlanır. |
setActiveRangeList(rangeList) | RangeList | Belirtilen aralık listesini, etkin sayfada active ranges olarak ayarlar. |
setActiveSelection(range) | Range | Bu sayfa için etkin seçim bölgesini ayarlar. |
setActiveSelection(a1Notation) | Range | Etkin seçimi, A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde ayarlar. |
setActiveSheet(sheet) | Sheet | Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. |
setActiveSheet(sheet, restoreSelection) | Sheet | Belirli bir sayfayı e-tablodaki etkin sayfa olarak ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar. |
setColumnWidth(columnPosition, width) | Sheet | Belirli bir sütunun genişliğini piksel cinsinden ayarlar. |
setCurrentCell(cell) | Range | Belirtilen hücreyi current cell olarak ayarlar. |
setFrozenColumns(columns) | void | Belirli sayıda sütunu dondurur. |
setFrozenRows(rows) | void | Belirli sayıda satırı dondurur. |
setIterativeCalculationConvergenceThreshold(minThreshold) | Spreadsheet | Yinelemeli hesaplama için minimum eşik değerini belirler. |
setIterativeCalculationEnabled(isEnabled) | Spreadsheet | Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını belirler. |
setMaxIterativeCalculationCycles(maxIterations) | Spreadsheet | Yinelemeli hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama yinelemesi sayısını belirler. |
setNamedRange(name, range) | void | Aralığı adlandırır. |
setRecalculationInterval(recalculationInterval) | Spreadsheet | Bu e-tablonun ne sıklıkta yeniden hesaplanması gerektiğini ayarlar. |
setRowHeight(rowPosition, height) | Sheet | Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. |
setSpreadsheetLocale(locale) | void | E-tablo yerel ayarını belirler. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | E-tabloda bir tema ayarlar. |
setSpreadsheetTimeZone(timezone) | void | E-tablonun saat dilimini ayarlar. |
show(userInterface) | void | Kullanıcının tarayıcısının görüntü alanında ortalanmış bir iletişim kutusunda özel kullanıcı arayüzü bileşeni görüntüler. |
sort(columnPosition) | Sheet | Sayfayı sütuna göre artan düzende sıralar. |
sort(columnPosition, ascending) | Sheet | Sayfayı sütuna göre sıralar. |
toast(msg) | void | E-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir. |
toast(msg, title) | void | E-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir. |
toast(msg, title, timeoutSeconds) | void | E-tablonun sağ alt köşesinde, başlığı ve mesajı içeren ve belirli bir süre boyunca görünür olan bir pop-up pencere gösterir. |
unhideColumn(column) | void | Belirtilen aralıktaki sütunu gösterir. |
unhideRow(row) | void | Verilen aralıktaki satırı gösterir. |
updateMenu(name, subMenus) | void | addMenu(name, subMenus) tarafından eklenen bir menüyü günceller. |
waitForAllDataExecutionsCompletion(timeoutInSeconds) | void | E-tablodaki mevcut tüm yürütme işlemleri tamamlanana kadar bekler ve belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar. |
Ayrıntılı belgeler
addDeveloperMetadata(key)
Belirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya ekler.
// 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'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Belirtilen anahtar ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler.
// 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'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Belirtilen anahtar ve değeri içeren geliştirici meta verilerini e-tabloya ekler.
// 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'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlükle birlikte geliştirici meta verilerini e-tabloya ekler.
// 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'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verilerinin değeri. |
visibility | DeveloperMetadataVisibility | Yeni geliştirici meta verilerinin görünürlüğü. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(emailAddress)
Kullanıcıyı Spreadsheet
düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Eklenecek kullanıcının e-posta adresi. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(user)
Kullanıcıyı Spreadsheet
düzenleyici listesine ekler. Kullanıcı zaten görüntüleyen listesindeyse bu yöntem kullanıcıyı görüntüleyen listesinin dışına çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditors(emailAddresses)
Belirtilen kullanıcı dizisini, Spreadsheet
düzenleyicisi listesine ekler. Kullanıcılardan biri zaten görüntüleyen listesindeyse bu yöntem, söz konusu kullanıcıları görüntüleyen listesinin dışına çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddresses | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addMenu(name, subMenus)
E-tablo kullanıcı arayüzünde yeni bir menü oluşturur.
Her menü girişi, kullanıcı tanımlı bir işlevi çalıştırır. E-tablo yüklendiğinde menünün otomatik olarak oluşturulması için genellikle bunu onOpen()
işlevinden çağırmak istersiniz.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Oluşturulacak menünün adı. |
subMenus | Object[] | name ve functionName
parametreleriyle bir dizi JavaScript haritası. Dahil edilen kitaplıklardaki
Library.libFunction1 gibi işlevleri kullanabilirsiniz. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(emailAddress)
Kullanıcıyı Spreadsheet
öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Eklenecek kullanıcının e-posta adresi. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(user)
Kullanıcıyı Spreadsheet
öğesini görüntüleyenler listesine ekler. Kullanıcı zaten düzenleyenler listesindeyse bu yöntemin herhangi bir etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewers(emailAddresses)
Belirtilen kullanıcı dizisini, Spreadsheet
için görüntüleyen listesine ekler. Kullanıcılardan biri zaten düzenleyen listesindeyse bu yöntemin o kullanıcılar için bir etkisi yoktur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddresses | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
appendRow(rowContents)
Sayfadaki geçerli veri bölgesinin en altına bir satır ekler. Bir hücrenin içeriği =
ile başlıyorsa formül olarak yorumlanır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowContents | Object[] | Sayfadaki son satırdan sonra eklenecek değerler dizisi. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Belirli bir sütunun genişliğini, içeriğine sığacak şekilde ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Yeniden boyutlandırılacak sütunun konumu. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy(name)
E-tabloyu kopyalar ve yeni e-tabloyu döndürür.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Kopyanın adı. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Bu e-tablonun kapsamında geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder
döndürür. Varsayılan olarak e-tablo, e-tablo, satır ve sütunlarla ilişkili tüm meta veriler dikkate alınır.
// 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'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
Return
DeveloperMetadataFinder
: Bu e-tablonun kapsamındaki meta verileri aramak için kullanılan geliştirici meta veri bulucu.
createTextFinder(findText)
E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirmek için kullanılabilir. Arama, e-tablonun ilk sayfasından başlar.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
findText | String | Aranacak metin. |
Return
TextFinder
: E-tablo için TextFinder
.
deleteActiveSheet()
O anda etkin olan sayfayı siler.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Return
Sheet
: Yeni etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumn(columnPosition)
Belirtilen sütun konumundaki sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | İlk sütun için 1'den başlayarak sütunun konumu. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Belirtilen sütun konumundan başlayarak belirli bir sayıda sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Silinecek ilk sütunun konumu. |
howMany | Integer | Silinecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Belirtilen satır konumundaki satırı siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İlk satır için 1'den başlayan satır konumu. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Belirtilen satır konumundan başlayan sayıda satırı siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | Silinecek ilk satırın konumu. |
howMany | Integer | Silinecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteSheet(sheet)
Belirtilen sayfayı siler.
// The code below deletes the specified sheet. var ss = SpreadsheetApp.getActive(); var sheet = ss.getSheetByName('My Sheet'); ss.deleteSheet(sheet);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Silinecek sayfa. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
duplicateActiveSheet()
Etkin sayfayı kopyalar ve etkin sayfa haline getirir.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveCell()
Bu sayfadaki etkin hücreyi döndürür.
Not: Geçerli olarak vurgulanmış hücreyi döndüren getCurrentCell()
işlevinin kullanılması tercih edilir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Return
Range
- şu anki etkin hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Etkin sayfada seçilen aralığı veya etkin 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.
"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı, ancak özel bir işlevde etkin olarak yeniden hesaplanan hücreyi ifade eder.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var activeRange = sheet.getActiveRange();
Return
Range
- etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
getActiveRangeList()
Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null
değerini döndürür.
Tek bir aralık seçiliyse bu bir getActiveRange()
çağrısı olarak davranır.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Return
RangeList
- etkin aralıkların listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
getActiveSheet()
Bir e-tablodaki etkin sayfayı alır.
Bir e-tablodaki etkin sayfa, e-tablo kullanıcı arayüzünde görüntülenen sayfadır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Return
Sheet
: E-tablodaki etkin sayfa.
getAs(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürün. Bu yöntem, dosya adına uygun uzantıyı ekler (örneğin, "dosyam.pdf"). Bununla birlikte, dosya adında son noktanın ardından gelen bölümün (varsa) değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "ShoppingList.12.25.2014", "ShoppingList.12.25.pdf" haline gelir.
Günlük dönüşüm kotalarını görüntülemek için Google Hizmetleri Kotalar bölümüne bakın. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüştürülecek MIME türü. Çoğu blob için geçerli tek seçenek 'application/pdf' 'tir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerleri de geçerlidir. |
Return
Blob
: Blob halinde veriler.
getBandings()
Bu e-tablodaki tüm bantları döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
Return
Banding[]
— Bu e-tablodaki şeritler.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBlob()
getColumnWidth(columnPosition)
Belirli bir sütunun genişliğini piksel olarak alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | İncelenecek sütunun konumu. |
Return
Integer
— piksel cinsinden sütun genişliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCurrentCell()
Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null
değerini döndürür. Mevcut hücre, Google E-Tablolar kullanıcı arayüzünde odağı olan ve koyu bir kenarlıkla vurgulanmış hücredir. Hiçbir zaman birden fazla geçerli hücre olmaz. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde, seçimdeki hücrelerden biri geçerli hücre olur.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Return
Range
- geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRange()
Verilerin bulunduğu boyutlara karşılık gelen bir Range
döndürür.
Bu, işlevsel olarak A1 ve (Sheet.getLastColumn(), Sheet.getLastRow()) ile sınırlı bir Aralık oluşturmaya eşdeğerdir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Return
Range
: E-tablodaki tüm verileri içeren bir aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Tüm veri kaynağı formüllerini alır.
// Opens the spreadsheet by its ID. If you created your script from within a Google Sheets // file, use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source formulas on Sheet1. // To get an array of data source formulas for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceFormulas = sheet.getDataSourceFormulas(); // Logs the first data source formula in the array. console.log(dataSourceFormulas[0].getFormula());
Return
DataSourceFormula[]
: Veri kaynağı formüllerinin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Tüm veri kaynağı pivot tablolarını alır.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of the data source pivot tables on Sheet1. // To get an array of data source pivot tables for the entire // spreadsheet, replace 'sheet' with 'ss'. const dataSourcePivotTables = sheet.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Return
DataSourcePivotTable[]
: Veri kaynağı pivot tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceRefreshSchedules()
Bu e-tablonun yenileme programlarını alır.
// 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'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
Return
DataSourceRefreshSchedule[]
— Bu e-tablonun yenileme planları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceSheets()
E-tablodaki tüm veri kaynağı sayfalarını döndürür.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
Return
DataSourceSheet[]
: Tüm veri kaynağı sayfalarını içeren dizi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Tüm veri kaynağı tablolarını alır.
// 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 Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets an array of data source tables on Sheet1. // To get an array of data source tables for the entire spreadsheet, // replace 'sheet' with 'ss'. const dataSourceTables = sheet.getDataSourceTables(); // Logs the last completed data execution time on the first data source table. console.log(dataSourceTables[0].getStatus().getLastExecutionTime());
Return
DataSourceTable[]
: Veri kaynağı tablolarının listesidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSources()
E-tablodaki tüm veri kaynaklarını döndürür.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
Return
DataSource[]
: Tüm veri kaynaklarını içeren dizi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Üst düzey e-tabloyla ilişkilendirilen geliştirici meta verilerini alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
Return
DeveloperMetadata[]
: Bu aralıkla ilişkili geliştirici meta verileri.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getEditors()
Bu Spreadsheet
için düzenleyenlerin listesini alır.
Return
User[]
: Düzenleme iznine sahip olan kullanıcı dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Yanıtlarını bu e-tabloya gönderen formun URL'sini veya bu e-tablonun ilişkilendirilmiş bir formu yoksa null
değerini döndürür. Bu e-tabloya birden fazla form yanıt gönderiyorsa döndürülen form URL'si belirsiz olur. Alternatif olarak, sayfa başına form URL ilişkilendirmeleri Sheet.getFormUrl()
yöntemiyle alınabilir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
Return
String
: Yanıtlarını bu e-tabloya yerleştiren formun URL'si veya bu e-tablonun ilişkili bir formu yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenColumns()
Dondurulmuş sütunların sayısını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Return
Integer
- dondurulmuş sütunların sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Dondurulmuş satırların sayısını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Return
Integer
— dondurulmuş satırların sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getId()
Bu e-tablo için benzersiz bir tanımlayıcı alır. E-tablo kimliği URL'sinden çıkarılabilir. Örneğin, https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 URL'sindeki e-tablo kimliği "abc1234567"dir.
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
Return
String
: E-tablonun benzersiz kimliği (veya anahtarı).
getImages()
Sayfadaki tüm ızgara içi resimleri döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the over-the-grid images from Sheet1. // To get the over-the-grid images from the entire spreadsheet, use ss.getImages() instead. const images = sheet.getImages(); // For each image, logs the anchor cell in A1 notation. for (const image of images) { console.log(image.getAnchorCell().getA1Notation()); }
Return
OverGridImage[]
: Izgaradan bir dizi resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIterativeCalculationConvergenceThreshold()
Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. Ardışık hesaplamanın sonuçları bu değerden daha az farklılık gösterdiğinde yinelemeli hesaplama durur.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Return
Number
: Yakınsaklık eşiği.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
İçeriği olan son sütunun konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: Sayfanın içerik barındıran son sütunu
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
İçeriği olan son satırın konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: Sayfanın içerik barındıran son satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMaxIterativeCalculationCycles()
Yinelemeli hesaplama sırasında kullanılacak maksimum yineleme sayısını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Return
Integer
: Maksimum hesaplama yineleme sayısı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getName()
Belgenin adını alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Return
String
: E-tablonun adı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNamedRanges()
Bu e-tablodaki tüm adlandırılmış aralıkları alır.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Return
NamedRange[]
: E-tablodaki adlandırılmış tüm aralıkların bir dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumSheets()
Bu e-tablodaki sayfa sayısını döndürür.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Return
Integer
: E-tablodaki sayfa sayısı.
getOwner()
Dokümanın sahibini veya ortak Drive'daki bir doküman için null
değerini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Return
User
: Dokümanın sahibi veya doküman ortak Drive'daysa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getPredefinedSpreadsheetThemes()
Önceden tanımlanmış temaların listesini döndürür.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Return
SpreadsheetTheme[]
: Önceden tanımlanmış temaların listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getProtections(type)
E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne dizisini alır.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
type | ProtectionType | Korunan alanın türü (SpreadsheetApp.ProtectionType.RANGE veya SpreadsheetApp.ProtectionType.SHEET ). |
Return
Protection[]
: E-tablodaki tüm korunan aralıkları veya sayfaları temsil eden bir nesne dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
Aralığı A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi döndürür.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 gösteriminde veya R1C1 gösteriminde belirtildiği gibi döndürülecek aralık. |
Return
Range
- belirlenen konumdaki aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeByName(name)
Adlandırılmış aralık veya belirtilen ada sahip herhangi bir aralık bulunmazsa null
döndürür. E-tablonun birden fazla sayfası aynı aralık adını kullanıyorsa sayfa adını ek tırnak işaretleri olmadan belirtin. Örneğin getRangeByName('TaxRates')
veya getRangeByName('Sheet Name!TaxRates')
girin ancak getRangeByName('"Sheet
Name"!TaxRates')
belirtmeyin.
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Alınacak aralığın adı. |
Return
Range
: Belirtilen ada sahip hücre aralığı.
getRangeList(a1Notations)
Aynı sayfadaki aralıkları temsil eden RangeList
koleksiyonunu döndürür.
// Get a list of ranges A1:D4, F1:H4. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notations | String[] | A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde döndürülecek aralıkların listesi. |
Return
RangeList
: Belirlenen konumdaki aralık listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRecalculationInterval()
Bu e-tabloya ilişkin hesaplama aralığını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Return
RecalculationInterval
: Bu e-tablo için hesaplama aralığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Belirli bir satırın piksel cinsinden yüksekliğini alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İncelenecek satırın konumu. |
Return
Integer
— piksel cinsinden satır yüksekliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri 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.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
— mevcut seçim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetByName(name)
Belirtilen ada sahip bir sayfa döndürür.
Aynı ada sahip birden fazla sayfa varsa en soldaki sayfa döndürülür. Belirtilen ada sahip bir sayfa yoksa null
değerini döndürür.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Alınacak sayfanın adı. |
Return
Sheet
: Belirtilen ada sahip sayfa.
getSheetId()
Bu nesnenin temsil ettiği sayfanın kimliğini döndürür.
Bu, e-tabloya özgü olan sayfanın kimliğidir. Kimlik, sayfa oluşturma zamanında atanan, sayfa konumundan bağımsız olan monoton olarak artan bir tam sayıdır. Bu, Sheet
örneği yerine gridId
parametresini alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
gibi yöntemlerle birlikte yararlıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
: E-tabloya özgü sayfanın kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetName()
Sayfa adını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Return
String
- sayfanın adı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetValues(startRow, startColumn, numRows, numColumns)
Verilen koordinatlardan başlayarak bu aralık için değerlerin dikdörtgen ızgarasını döndürür. Satır veya sütun konumu olarak verilen -1 değeri, sayfada veri bulunan en son satırı veya sütunu almaya eş değerdir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
startRow | Integer | Başlangıç satırının konumu. |
startColumn | Integer | Başlangıç sütununun konumu. |
numRows | Integer | Değer döndürülecek satır sayısı. |
numColumns | Integer | Değer döndürülecek sütun sayısı. |
Return
Object[][]
: İki boyutlu değerler dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheets()
Bu e-tablodaki tüm sayfaları alır.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Return
Sheet[]
: E-tablodaki tüm sayfaları içeren bir dizi.
getSpreadsheetLocale()
E-tablo yerel ayarını alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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 the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Return
String
: E-tablonun yerel ayarı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTheme()
E-tablonun geçerli temasını veya herhangi bir tema uygulanmazsa null
değerini döndürür.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Return
SpreadsheetTheme
: Uygulanan geçerli tema.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTimeZone()
E-tablonun saat dilimini alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Return
String
— "Uzun" biçimde belirtilen saat dilimi (örneğin, Joda.org tarafından
listelenen "Amerika/New_York").
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
Belirli e-tablonun URL'sini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Return
String
: Belirli e-tablonun URL'si.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getViewers()
Bu Spreadsheet
için görüntüleyenlerin ve yorum yapanların listesini alır.
Return
User[]
: Görüntüleme veya yorum yapma iznine sahip bir kullanıcı dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Belirli bir aralıktaki sütunu veya sütunları gizler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizlenecek sütun aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Verilen aralıktaki satırları gizler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizlenecek satır aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Belirtilen sütun konumundan sonra bir sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Yeni sütunun ekleneceği sütundur. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Belirtilen sütun konumundan önce bir sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Önüne yeni sütunun ekleneceği sütun. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Belirtilen sütun konumundan sonra belirtilen sayıda sütun ekler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Yeni sütunun ekleneceği sütundur. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Belirtilen sütun konumundan önce belirli sayıda sütun ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Önüne yeni sütunun ekleneceği sütun. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertDataSourceSheet(spec)
E-tabloya yeni bir DataSourceSheet
ekler ve veri yürütme işlemini başlatır. Bu da yeni sayfayı etkin sayfa haline getirir.
Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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'); // 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);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | DataSourceSpec | Eklenecek veri kaynağı spesifikasyonu. |
Return
DataSourceSheet
: Yeni veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Dokümanda belirli bir satır ve sütunda resim olarak bir Spreadsheet
ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob. |
column | Integer | Sütun konumu. |
row | Integer | Satır konumu. |
Return
OverGridImage
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row, offsetX, offsetY)
Dokümanda belirli bir satır ve sütunda, piksel ofseti ile resim olarak Spreadsheet
ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blobSource | BlobSource | Resim içeriklerini, MIME türünü ve (isteğe bağlı olarak) adı içeren blob. |
column | Integer | Sütun konumu. |
row | Integer | Satır konumu. |
offsetX | Integer | Hücre köşesinden yatay uzaklık. |
offsetY | Integer | Hücre köşesinden dikey ofsetin piksel cinsinden değeri. |
Return
OverGridImage
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Dokümana belirli bir satıra ve sütuna resim ekler.
Sağlanan URL herkesin erişimine açık olmalıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | Resmin URL'si. |
column | Integer | Izgara sütunu konumu. |
row | Integer | Izgara satırı konumu. |
Return
OverGridImage
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row, offsetX, offsetY)
Dokümanda belirli bir satır ve sütunda, piksel ofsetiyle bir resim ekler.
Sağlanan URL herkesin erişimine açık olmalıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | Görselin URL'si. |
column | Integer | Sütun konumu. |
row | Integer | Satır konumu. |
offsetX | Integer | Hücre köşesinden yatay uzaklık. |
offsetY | Integer | Hücre köşesinden dikey ofsetin piksel cinsinden değeri. |
Return
OverGridImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Belirtilen satır konumundan sonra bir satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Yeni satırın ekleneceği satır. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Belirtilen satır konumundan önce bir satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Önüne yeni satırın eklenmesi gereken satır. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Belirtilen satır konumundan sonraya belirli sayıda satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
afterPosition | Integer | Yeni satırların ekleneceği satır. |
howMany | Integer | Eklenecek satır sayısı. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Belirtilen satır konumundan önceye belirli sayıda satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
beforePosition | Integer | Önüne yeni satır eklenmesi gereken satır. |
howMany | Integer | Eklenecek satır sayısı. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet()
Varsayılan sayfa adını kullanarak e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex)
Belirtilen dizindeki e-tabloya yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetIndex | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex, options)
Belirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetIndex | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın. |
options | Object | İsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(options)
Varsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen isteğe bağlı gelişmiş JavaScript bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, bu e-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName)
E-tabloya belirtilen adla yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetName | String | Yeni sayfanın adı. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex)
E-tabloya, verilen dizinde belirtilen adla yeni bir sayfa ekler. Yeni sayfa etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetName | String | Yeni sayfanın adı. |
sheetIndex | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex, options)
E-tabloya, belirtilen dizinde belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetName | String | Yeni sayfanın adı. |
sheetIndex | Integer | Yeni eklenen sayfanın dizini. Bir sayfayı e-tablodaki ilk sayfa olarak eklemek için sayfayı 0 olarak ayarlayın. |
options | Object | İsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, options)
E-tabloya belirtilen adla yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenler kullanır. Yeni sayfa, etkin sayfa haline gelir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetName | String | Yeni sayfanın adı. |
options | Object | İsteğe bağlı gelişmiş JavaScript bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheetWithDataSourceTable(spec)
E-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir DataSourceTable
oluşturur ve veri yürütme işlemini başlatır. Bir yan etki olarak, yeni sayfayı etkin sayfa haline getirir.
Veri kaynağı türü etkinleştirilmemişse istisna oluşturur. Belirli veri kaynağı türlerinde veri yürütmeyi etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | DataSourceSpec | Eklenecek veri kaynağı spesifikasyonu. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isColumnHiddenByUser(columnPosition)
Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | İncelenecek sütunun konumu. |
Return
Boolean
— Sütun gizliyse true
, aksi takdirde false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isIterativeCalculationEnabled()
Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Return
Boolean
— Yinelemeli hesaplama etkinse true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Belirli bir satırın bir filtre tarafından gizlenip gizlenmediğini döndürür (filtre görünümü değil).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İncelenecek satırın konumu. |
Return
Boolean
— Satır gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Belirli bir satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | İncelenecek satırın konumu. |
Return
Boolean
— Satır gizliyse true
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveActiveSheet(pos)
Etkin sayfayı, sayfa listesinde belirli bir konuma taşır. Konum negatifse veya sayfa sayısından büyükse bir istisna atar.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pos | Integer | Etkin sayfanın, sayfalar listesinde taşınacağı 1 dizin konumu. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveChartToObjectSheet(chart)
Yeni bir SheetType.OBJECT
sayfası oluşturur ve sağlanan grafiği bu e-tabloya taşır. Grafik zaten kendi sayfasındaysa bu sayfa yeni bir sayfa oluşturulmadan döndürülür.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | EmbeddedChart | Taşınacak grafik. |
Return
Sheet
: Grafiğin bulunduğu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshAllDataSources()
Geçersiz veri kaynağı nesnelerini atlayarak desteklenen tüm veri kaynaklarını ve bunlara bağlı veri kaynağı nesnelerini yeniler.
Belirli veri kaynağı türleri için veri yürütmeyi etkinleştirmek amacıyla SpreadsheetApp#enable...Execution()
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // 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 the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(emailAddress)
Kullanıcıyı, Spreadsheet
düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Spreadsheet
, kullanıcının tüm alan adıyla paylaşılıyorsa veya Spreadsheet
, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Spreadsheet
ürününe erişmesini engellemez.
Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(user)
Kullanıcıyı, Spreadsheet
düzenleyici listesinden kaldırır. Genel erişime sahip bir kullanıcı sınıfına ait olan (örneğin, Spreadsheet
, kullanıcının tüm alan adıyla paylaşılıyorsa veya Spreadsheet
, kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa) bu yöntem, kullanıcıların Spreadsheet
ürününe erişmesini engellemez.
Bu işlem, Drive dosyalarını görüntüleyenler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeMenu(name)
addMenu(name, subMenus)
tarafından eklenen menüyü kaldırır. name
bağımsız değişkeni, addMenu(name, subMenus)
öğesine karşılık gelen çağrıyla aynı değere sahip olmalıdır.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.removeMenu("badMenu"); // name must match the name used when added the menu } function foo(){ // Do nothing }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Kaldırılacak menünün adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeNamedRange(name)
Verilen ada sahip olan adlandırılmış bir aralığı siler. E-tabloda belirtilen ada sahip herhangi bir aralık bulunamazsa istisna oluşturur.
// The code below creates a new named range "foo", and then remove it. var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("foo", ss.getActiveRange()); ss.removeNamedRange("foo");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Aralık adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeViewer(emailAddress)
İlgili kullanıcıyı, Spreadsheet
için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı düzenleyen veya görüntüleyen ya da yorumcu değilse bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Spreadsheet
, kullanıcının tüm alanıyla paylaşılıyorsa veya Spreadsheet
kullanıcının erişebildiği bir ortak Drive'da yer alıyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında yer alan kullanıcıların Spreadsheet
öğesine erişimini de engellemez.
Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
emailAddress | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Spreadsheet
— Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeViewer(user)
İlgili kullanıcıyı, Spreadsheet
için görüntüleyenler ve yorum yapanlar listesinden kaldırır. Kullanıcı görüntüleyen değil düzenleyense bu yöntemin herhangi bir etkisi yoktur. Ayrıca, Spreadsheet
kullanıcının tüm alanıyla paylaşılıyorsa veya Spreadsheet
kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa bu yöntem, genel erişime sahip bir kullanıcı sınıfında bulunan kullanıcıların Spreadsheet
öğesine erişimini de engellemez.
Bu işlem, Drive dosyalarında kullanıcıyı düzenleyenler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Spreadsheet
— Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
rename(newName)
Dokümanı yeniden adlandırır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.rename("This is the new name");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
newName | String | Dokümanın yeni adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
renameActiveSheet(newName)
Geçerli etkin sayfayı verilen yeni adla yeniden adlandırır.
// The code below renames the active sheet to "Hello world" SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
newName | String | Geçerli etkin sayfanın yeni adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
resetSpreadsheetTheme()
Uygulanan temayı kaldırır ve e-tablodaki varsayılan temayı ayarlar.
// The code below applies default theme on the spreadsheet. SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();
Return
SpreadsheetTheme
: Varsayılan tema.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRange(range)
Belirtilen aralığı etkin sayfada active range
olarak ayarlar ve aralıktaki sol üstteki hücre current cell
olarak ayarlanır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin aralık olarak ayarlanacak aralık. |
Return
Range
— yeni etkinleştirilen aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveRangeList(rangeList)
Belirtilen aralık listesini, etkin sayfada active ranges
olarak ayarlar. Listedeki son aralık active range
olarak ayarlanmıştır.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(range)
Bu sayfa için etkin seçim bölgesini ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin seçim olarak ayarlanacak aralık. |
Return
Range
— yeni etkinleştirilen aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSelection(a1Notation)
Etkin seçimi, A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.setActiveSelection("A1:D4");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 gösteriminde veya R1C1 gösteriminde belirtildiği şekilde, etkin olarak ayarlanacak aralık. |
Return
Range
— yeni etkinleştirilen aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSheet(sheet)
Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. Google E-Tablolar kullanıcı arayüzü, sayfa farklı bir e-tabloya ait değilse seçilen sayfayı görüntüler.
// The code below makes the first sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Etkin sayfa olarak ayarlanacak sayfa. |
Return
Sheet
: Etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setActiveSheet(sheet, restoreSelection)
Belirli bir sayfayı e-tablodaki etkin sayfa olarak ayarlar ve bu sayfadaki en son seçimi geri yükleme seçeneği sunar. Google E-Tablolar kullanıcı arayüzü, sayfa farklı bir e-tabloya ait değilse seçilen sayfayı görüntüler.
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 | Tf true 'da, yeni etkin sayfanın en son seçimi yeni sayfa etkin hale geldiğinde tekrar seçilir. false değerine ayarlanırsa 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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setColumnWidth(columnPosition, width)
Belirli bir sütunun genişliğini piksel cinsinden ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Ayarlanacak sütunun konumu. |
width | Integer | Ayarlanacak genişlik (piksel cinsinden). |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setCurrentCell(cell)
Belirtilen hücreyi current cell
olarak ayarlar.
Belirtilen hücre zaten seçili olan bir aralıkta bulunuyorsa bu aralık, geçerli hücre olarak hücreyle etkin aralık haline gelir.
Belirtilen hücre seçilen herhangi bir aralıkta yer almıyorsa mevcut seçim kaldırılır ve hücre, geçerli hücre ve etkin aralık olur.
Not: Belirtilen Range
bir hücreden oluşmalıdır, aksi takdirde bir istisnaya neden olur.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.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 kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenColumns(columns)
Belirli sayıda sütunu dondurur. Sıfırsa hiçbir sütun dondurulmaz.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Integer | Dondurulacak sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFrozenRows(rows)
Belirli sayıda satırı dondurur. Sıfırsa hiçbir satır dondurulmaz.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rows | Integer | Dondurulacak satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setIterativeCalculationConvergenceThreshold(minThreshold)
Yinelemeli hesaplama için minimum eşik değerini belirler. Ardışık hesaplamanın sonuçları bu değerden daha az farklılık gösterdiğinde yinelemeli hesaplama durur. Bu değer, negatif olmayan bir değer olmalıdır ve varsayılan olarak 0,05'tir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
minThreshold | Number | Minimum yakınlaşma eşiği (negatif olmamalıdır). |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setIterativeCalculationEnabled(isEnabled)
Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını belirler. Hesaplama etkinleştirildiğinde maksimum hesaplama döngüsü sayısı ve yakınsaklık eşiği daha önce ayarlanmamışsa bunlar varsayılan olarak sırasıyla 50 ve 0, 05 olur. Bunlardan biri daha önce ayarlandıysa önceki değerlerini korur.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
isEnabled | Boolean | Yinelemeli hesaplamanın etkinleştirilmesi gerekiyorsa true ; aksi takdirde false . |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setMaxIterativeCalculationCycles(maxIterations)
Yinelemeli hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama yinelemesi sayısını belirler. Bu değer 1 ile 10.000 (dahil) arasında olmalıdır ve varsayılan olarak 50 değerine ayarlanır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
maxIterations | Integer | Maksimum hesaplama yineleme sayısı (1 ile 10.000 arasında). |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNamedRange(name, range)
Aralığı adlandırır.
// The code below creates a new named range "TaxRates" in the active spreadsheet var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Aralığa verilecek ad. |
range | Range | Aralık spesifikasyonu. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRecalculationInterval(recalculationInterval)
Bu e-tablonun ne sıklıkta yeniden hesaplanması gerektiğini ayarlar.
// 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'); // Sets the calculation interval for the spreadsheet to 'ON_CHANGE'. const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE); // Logs the calculation interval to the console. console.log(interval);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
recalculationInterval | RecalculationInterval | Yeni yeniden hesaplama aralığı. |
Return
Spreadsheet
— Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRowHeight(rowPosition, height)
Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. Varsayılan olarak, satırlar hücre içeriğine sığacak şekilde büyür. Satırları belirli bir yüksekliğe zorlamak istiyorsanız Sheet.setRowHeightsForced(startRow, numRows, height)
değerini kullanın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rowPosition | Integer | Değiştirilecek satır konumu. |
height | Integer | Ayarlanacak piksel cinsinden yükseklik. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSpreadsheetLocale(locale)
E-tablo yerel ayarını belirler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the spreadsheet locale. ss.setSpreadsheetLocale('fr'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
locale | String | Kullanılacak yerel ayar kodu (ör. "en", "fr" veya "en_US"). |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSpreadsheetTheme(theme)
E-tabloda bir tema ayarlar.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
theme | SpreadsheetTheme | Uygulanacak tema. |
Return
SpreadsheetTheme
: Yeni geçerli tema.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setSpreadsheetTimeZone(timezone)
E-tablonun saat dilimini ayarlar.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, 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'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timezone | String | "Uzun" biçimde belirtilen saat dilimi (örneğin, Joda.org tarafından listelendiği şekliyle "Amerika/New_York"). |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show(userInterface)
Kullanıcının tarayıcısının görüntü alanında ortalanmış bir iletişim kutusunda özel kullanıcı arayüzü bileşeni görüntüler. Sunucu tarafı komut dosyasının yürütme işlemi askıya alınmaz. Kullanıcı arayüzü bileşeninin, sunucu tarafıyla iletişim kurmak için sunucu tarafı komut dosyasına eşzamansız geri çağırmalar yapması gerekir.
Sunucu tarafı komut dosyasında daha önce henüz kapatılmamış bir iletişim kutusu görüntüleniyorsa mevcut iletişim kutusu, yeni istenen iletişim kutusunun kullanıcı arayüzüyle değiştirilir.
Aşağıdaki kod snippet'i, belirtilen başlık, yükseklik ve genişlikle birlikte bir iletişim kutusunda basit bir HtmlService
uygulamasını gösterir:
var htmlApp = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My HtmlService Application') .setWidth(250) .setHeight(300); SpreadsheetApp.getActiveSpreadsheet().show(htmlApp); // The script resumes execution immediately after showing the dialog.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
userInterface | Object | HtmlOutput . |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/script.container.ui
sort(columnPosition)
Sayfayı sütuna göre artan düzende sıralar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Sıralama ölçütü olarak kullanılacak sütun. |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Sayfayı sütuna göre sıralar. Artan veya azalan düzende belirtilecek bir parametre alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columnPosition | Integer | Sıralama ölçütü olarak kullanılacak sütun. |
ascending | Boolean | Artan sıralama için true , azalan sıralama için false . |
Return
Sheet
: Yöntem zinciri açısından yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
toast(msg)
E-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir.
// Show a popup with the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Durum mesajında gösterilecek mesaj. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
toast(msg, title)
E-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir.
// Show a popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Durum mesajında gösterilecek mesaj. |
title | String | Kısa iletinin isteğe bağlı başlığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
toast(msg, title, timeoutSeconds)
E-tablonun sağ alt köşesinde, başlığı ve mesajı içeren ve belirli bir süre boyunca görünür olan bir pop-up pencere gösterir.
// Show a 3-second popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Durum mesajında gösterilecek mesaj. |
title | String | Kısa iletinin isteğe bağlı başlığı. |
timeoutSeconds | Number | Saniye cinsinden zaman aşımı. null değerine ayarlanırsa durum mesajı varsayılan olarak 5 saniyeye ayarlanır.
Negatifse durum mesajı kapatılana kadar kalır. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideColumn(column)
Belirtilen aralıktaki sütunu gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizlenmişse gösterilecek aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhideRow(row)
Verilen aralıktaki satırı gösterir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizlenmişse gösterilecek aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
updateMenu(name, subMenus)
addMenu(name, subMenus)
tarafından eklenen bir menüyü günceller. addMenu(name, subMenus)
ile tam olarak aynı şekilde çalışır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; menuEntries.push({name: "Lone Menu Entry", functionName: "function1"}); ss.updateMenu("addMenuExample", menuEntries);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Güncellenecek menünün adı. |
subMenus | Object[] | name ve functionName
parametreleriyle bir dizi JavaScript haritası. Dahil edilen kitaplıklardaki
Library.libFunction1 gibi işlevleri kullanabilirsiniz. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
waitForAllDataExecutionsCompletion(timeoutInSeconds)
E-tablodaki mevcut tüm yürütme işlemleri tamamlanana kadar bekler ve belirtilen sayıda saniye geçtikten sonra zaman aşımına uğrar. Yürütmeler zaman aşımına uğradığında tamamlanmazsa ancak veri yürütme işlemlerini iptal etmezse bir istisna oluşturur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeoutInSeconds | Integer | Veri yürütme işlemlerinin bekleme süresi (saniye cinsinden). Maksimum süre 300 saniyedir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamların biri veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets