Google E-Tablolar dosyalarına erişebilir ve bu dosyaları değiştirebilir. Sık yapılan işlemler arasında yeni sayfa ekleme ve birlikte çalışır.
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üğe sahip geliştirici meta verilerini e-tabloya ekler. |
addDeveloperMetadata(key, value) | Spreadsheet | Belirtilen anahtar ve değere sahip geliştirici meta verilerini e-tabloya ekler. |
addDeveloperMetadata(key, value, visibility) | Spreadsheet | Belirtilen anahtar, değer ve görünürlüğe sahip geliştirici meta verilerini e-tabloya ekler. |
addEditor(emailAddress) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler. |
addEditor(user) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesine ekler. |
addEditors(emailAddresses) | Spreadsheet | Belirtilen kullanıcı dizisini, Spreadsheet için düzenleyenler listesine ekler. |
addMenu(name, subMenus) | void | E-tablo kullanıcı arayüzünde yeni bir menü oluşturur. |
addViewer(emailAddress) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler. |
addViewer(user) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler listesine ekler. |
addViewers(emailAddresses) | Spreadsheet | Belirtilen kullanıcı dizisini, Spreadsheet için görüntüleyenler listesine ekler. |
appendRow(rowContents) | Sheet | Sayfadaki geçerli veri bölgesinin altına bir satır ekler. |
autoResizeColumn(columnPosition) | Sheet | Belirli bir sütunun genişliğini, içeriğine uyacak şekilde ayarlar. |
copy(name) | Spreadsheet | E-tabloyu kopyalar ve yeni e-tabloyu döndürür. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder döndürür:
e-tablo kullanabilirsiniz. |
createTextFinder(findText) | TextFinder | E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, içindeki metni bulup değiştirmek için kullanılabilir. e-tabloyla değiştirebilirsiniz. |
deleteActiveSheet() | Sheet | O anda etkin olan sayfayı siler. |
deleteColumn(columnPosition) | Sheet | Belirtilen sütun konumundaki sütunu siler. |
deleteColumns(columnPosition, howMany) | void | Belirli bir sütun konumundan başlayan bir dizi sütunu siler. |
deleteRow(rowPosition) | Sheet | Verilen satır konumundaki satırı siler. |
deleteRows(rowPosition, howMany) | void | Belirtilen satır konumundan başlayan satır sayısını siler. |
deleteSheet(sheet) | void | Belirtilen sayfayı siler. |
duplicateActiveSheet() | Sheet | Etkin sayfayı çoğaltır ve etkin sayfa haline getirir. |
getActiveCell() | Range | Bu sayfadaki etkin hücreyi döndürür. |
getActiveRange() | Range | Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. |
getActiveRangeList() | RangeList | Etkin sayfadaki etkin aralıkların listesini veya etkin aralık yoksa null 'i döndürür.
değerleridir. |
getActiveSheet() | Sheet | 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 şeritleri döndürür. |
getBlob() | Blob | Bu nesnenin içindeki verileri blob olarak döndürün. |
getColumnWidth(columnPosition) | Integer | Belirli bir sütunun piksel cinsinden genişliğini 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şkili geliştirici meta verilerini alır. |
getEditors() | User[] | Bu Spreadsheet için düzenleyenlerin listesini alır. |
getFormUrl() | String | Yanıtları bu e-tabloya gönderen formun URL'sini veya aşağıdaki durumlarda null değerini döndürür
bu e-tabloda ilişkilendirilmiş form yok. |
getFrozenColumns() | Integer | Dondurulmuş sütunların sayısını döndürür. |
getFrozenRows() | Integer | Dondurulmuş satır 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 kılavuz üzeri resimleri döndürür. |
getIterativeCalculationConvergenceThreshold() | Number | Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. |
getLastColumn() | Integer | İçerik barındıran son sütunun konumunu döndürür. |
getLastRow() | Integer | İçerik barındıran 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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi alır. |
getRange(a1Notation) | Range | A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı döndürür. |
getRangeByName(name) | Range | Adlandırılmış bir aralık veya belirtilen ada sahip bir aralık bulunamazsa null döndürür. |
getRangeList(a1Notations) | RangeList | Belirtilen sayfadaki aralıkları temsil eden RangeList koleksiyonunu döndürür
boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir. |
getRecalculationInterval() | RecalculationInterval | Bu e-tablonun hesaplama aralığını döndürür. |
getRowHeight(rowPosition) | Integer | Verilen 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 tema uygulanmadıysa null değerini döndürür. |
getSpreadsheetTimeZone() | String | E-tabloya ilişkin saat dilimini alır. |
getUrl() | String | Belirli bir e-tablonun URL'sini döndürür. |
getViewers() | User[] | Bu Spreadsheet için görüntüleyenlerin ve yorumcuların listesini alır. |
hideColumn(column) | void | Verilen aralıktaki sütunu veya sütunları gizler. |
hideRow(row) | void | Belirtilen aralıktaki satırları gizler. |
insertColumnAfter(afterPosition) | Sheet | Verilen sütun konumundan sonra bir sütun ekler. |
insertColumnBefore(beforePosition) | Sheet | Verilen sütun konumundan önce bir sütun ekler. |
insertColumnsAfter(afterPosition, howMany) | Sheet | Verilen sütun konumundan sonra belirli sayıda sütun ekler. |
insertColumnsBefore(beforePosition, howMany) | Sheet | Belirtilen sütun konumundan önce bir sayıda sütun ekler. |
insertDataSourceSheet(spec) | DataSourceSheet | E-tabloya yeni bir DataSourceSheet ekler ve veri yürütmeyi başlatır. |
insertImage(blobSource, column, row) | OverGridImage | Belirli bir satır ve sütundaki belgeye resim olarak Spreadsheet ekler. |
insertImage(blobSource, column, row, offsetX, offsetY) | OverGridImage | Belirli bir satır ve sütundaki belgeye resim olarak Spreadsheet ekler.
piksel uzaklığı. |
insertImage(url, column, row) | OverGridImage | Dokümana belirli bir satır ve sütundaki resim ekler. |
insertImage(url, column, row, offsetX, offsetY) | OverGridImage | Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir. |
insertRowAfter(afterPosition) | Sheet | Verilen satır konumundan sonra bir satır ekler. |
insertRowBefore(beforePosition) | Sheet | Verilen satır konumundan önce bir satır ekler. |
insertRowsAfter(afterPosition, howMany) | Sheet | Belirtilen satır konumundan sonra birkaç satır ekler. |
insertRowsBefore(beforePosition, howMany) | Sheet | Verilen satır konumundan önce birkaç 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şkenlerdir. |
insertSheet(options) | Sheet | Varsayılan sayfa adını ve isteğe bağlı gelişmişyi kullanarak e-tabloya yeni bir sayfa ekler bağımsız değişkenlerdir. |
insertSheet(sheetName) | Sheet | E-tabloya verilen ada yeni bir sayfa ekler. |
insertSheet(sheetName, sheetIndex) | Sheet | E-tabloya, belirtilen dizinde belirtilen ada sahip 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. |
insertSheet(sheetName, options) | Sheet | E-tabloya verilen ada sahip yeni bir sayfa ekler ve isteğe bağlı olarak gelişmiş bağımsız değişkenlerdir. |
insertSheetWithDataSourceTable(spec) | Sheet | E-tabloya yeni bir sayfa ekler, DataSourceTable
Veri kaynağı spesifikasyonunu içeren tüm sayfayı açar ve verileri yürütmeye başlar. |
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 etkinleştirilip etkinleştirilmediğini döndürür. |
isRowHiddenByFilter(rowPosition) | Boolean | Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür. |
isRowHiddenByUser(rowPosition) | Boolean | Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
moveActiveSheet(pos) | void | Etkin sayfayı sayfa listesinde belirtilen konuma taşır. |
moveChartToObjectSheet(chart) | Sheet | Yeni bir SheetType.OBJECT e-tablosu oluşturur ve sağlanan grafiği bu sayfaya taşır. |
refreshAllDataSources() | void | Geçersiz olanı atlayarak desteklenen tüm veri kaynaklarını ve bağlı veri kaynağı nesnelerini yeniler veri kaynağı nesneleridir. |
removeEditor(emailAddress) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır. |
removeEditor(user) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır. |
removeMenu(name) | void | addMenu(name, subMenus) tarafından eklenen bir menüyü kaldırır. |
removeNamedRange(name) | void | Verilen ada sahip bir adlandırılmış aralığı siler. |
removeViewer(emailAddress) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler ve yorumcular listesinden kaldırır. |
removeViewer(user) | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyenler ve yorumcular 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
current cell olarak aralıkta sol üstteki hücre. |
setActiveRangeList(rangeList) | RangeList | Belirtilen aralık listesini active ranges olarak
etkin sayfada. |
setActiveSelection(range) | Range | Bu sayfa için etkin seçim bölgesini ayarlar. |
setActiveSelection(a1Notation) | Range | A1 gösteriminde veya R1C1 notasyonunda belirtildiği gibi etkin seçimi ayarlar. |
setActiveSheet(sheet) | Sheet | Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. |
setActiveSheet(sheet, restoreSelection) | Sheet | Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar ve sayfadaki en son seçimi içerir. |
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 | Belirtilen sayıda sütunu dondurur. |
setFrozenRows(rows) | void | Belirtilen 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 etkinleştirilip etkinleştirilmeyeceğini belirler. |
setMaxIterativeCalculationCycles(maxIterations) | Spreadsheet | Yinelemeli işlem sırasında yapılması gereken maksimum hesaplama yinelemelerinin sayısını ayarlar hesaplamanız gerekir. |
setNamedRange(name, range) | void | Aralığa ad verir. |
setRecalculationInterval(recalculationInterval) | Spreadsheet | Bu e-tablonun ne sıklıkta yeniden hesaplama yapması gerektiğini ayarlar. |
setRowHeight(rowPosition, height) | Sheet | Belirli bir satırın satır yüksekliğini piksel cinsinden ayarlar. |
setSpreadsheetLocale(locale) | void | E-tablonun yerel ayarını belirler. |
setSpreadsheetTheme(theme) | SpreadsheetTheme | E-tabloda bir tema ayarlar. |
setSpreadsheetTimeZone(timezone) | void | E-tablonun saat dilimini ayarlar. |
show(userInterface) | void | Bir özel kullanıcı arayüzü bileşenini, kullanıcının tarayıcısının tarayıcısında ortalanmış bir iletişim kutusunda görüntüler görünüm. |
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ın bulunduğu bir pop-up pencere gösterir. |
toast(msg, title) | void | E-tablonun sağ alt köşesinde, verilen iletiyi içeren bir pop-up pencere ve başlığı ekleyin. |
toast(msg, title, timeoutSeconds) | void | E-tablonun sağ alt köşesinde, ilgili başlığı içeren bir pop-up pencere ve bir süre boyunca görünür kalan mesajdır. |
unhideColumn(column) | void | Sütunu belirtilen aralıkta 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ütmelerin tamamlanmasını bekler ve verilen saniye kadardır. |
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 amaçlı bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Belirtilen anahtar ve görünürlüğe sahip 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 amaçlı bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Belirtilen anahtar ve değere sahip 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 amaçlı bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlüğe sahip 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 amaçlı bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyenler listesine ekler. Kullanıcı zaten
bu yöntemle kullanıcıyı görüntüleyenler listesinden çı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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditor(user)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyenler listesine ekler. Kullanıcı zaten
bu yöntemle kullanıcıyı görüntüleyenler listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcıyı gösteren bir temsil. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addEditors(emailAddresses)
Belirtilen kullanıcı dizisini, Spreadsheet
için düzenleyenler listesine ekler.
İzleyici listesinde bulunan kullanıcılar, bu yöntem sayesinde diğer kullanıcılar tarafından
izleyiciler.
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 kapsamlardan bir 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 bu komutu 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
parametrelerine sahip bir dizi JavaScript eşleme. Dahil edilen kitaplıklardaki (
Library.libFunction1 gibi) işlevleri kullanabilirsiniz. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için görüntüleyenler listesine ekler. Kullanıcı zaten
kullanıyorsanız bu yöntemin herhangi bir etkisi yoktur.
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewer(user)
Belirtilen kullanıcıyı Spreadsheet
için görüntüleyenler listesine ekler. Kullanıcı zaten
kullanıyorsanız bu yöntemin herhangi bir etkisi yoktur.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcıyı gösteren bir temsil. |
Return
Spreadsheet
— Bu Spreadsheet
, zincirleme bağlantı için.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addViewers(emailAddresses)
Belirtilen kullanıcı dizisini, Spreadsheet
için görüntüleyenler listesine ekler.
kullanıcı zaten düzenleyenler listesinde olduğundan bu yöntemin onlar 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 kapsamlardan bir 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 altına bir satır ekler. Hücre içeriği
=
ile tekrar eklendiğinde 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 oluşturmak için yararlı olan e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoResizeColumn(columnPosition)
Belirli bir sütunun genişliğini, içeriğine uyacak ş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ırmak için belirtilen sütunun konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 amaçlı bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Şu kapsamdaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinder
döndürür:
e-tablo kullanabilirsiniz. Bu ayar varsayılan olarak e-tablo ile ilişkili tüm meta verileri
satır ve sütunlardan oluşur.
// 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 bir geliştirici meta veri bulucudur.
createTextFinder(findText)
E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, içindeki metni bulup değiştirmek için kullanılabilir. e-tabloyla değiştirebilirsiniz. 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 kapsamlardan bir 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 | Sütunun, ilk sütun için 1'den başlayan konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteColumns(columnPosition, howMany)
Belirli bir sütun konumundan başlayan bir dizi 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRow(rowPosition)
Verilen 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 | Satırın, ilk satır için 1'den başlayan konumu. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
deleteRows(rowPosition, howMany)
Belirtilen satır konumundan başlayan satır sayısını 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 kapsamlardan bir 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
duplicateActiveSheet()
Etkin sayfayı çoğaltır 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 kapsamlardan bir 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 parametreyi döndüren getCurrentCell()
kullanılması tercih edilir
vurgulanan hücreyi tıklayın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Return
Range
- geçerli etkin hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getActiveRange()
Etkin sayfada seçili aralığı veya etkin bir aralık yoksa null
değerini döndürür. Eğer
birden çok aralık seçilir. Bu yöntem yalnızca en son seçilen aralığı döndürür.
"Etkin aralık" terimi kullanıcının etkin sayfada seçtiği aralığı ifade eder. Ancak özel işlevde, hücrenin etkin bir şekilde yeniden hesaplandığını 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 kapsamlardan bir 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
'i döndürür.
değerleridir.
Tek bir aralık seçildiyse bu bir getActiveRange()
çağrısı gibi 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 kapsamlardan bir 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()
E-tablodaki etkin sayfayı alır.
Bir e-tablodaki etkin sayfa, o e-tabloda görüntülenmekte olan sayfadır. Kullanıcı arayüzü.
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öntemi, dosya adına uygun uzantıyı ekler. Örneğin, "dosyam.pdf". Ancak, dosya adında son noktadan sonra gelen bölümün (varsa) mevcut bir alan olduğunu varsayar değiştirilmesi gereken uzantıdır. Sonuç olarak, "AlışverişListesi.12.25.2014" şu olur: "ShoppingList.12.25.pdf".
Günlük dönüşüm kotalarını görüntülemek için bkz. Google için Kotalar Hizmetler. Yeni oluşturulan Google Workspace alanları geçici olarak daha sıkılığa tabi olabilir kotalar.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
contentType | String | Dönüşümün gerçekleştirileceği MIME türü. Çoğu blob için 'application/pdf' ,
tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' 'ten herhangi biri de
geçerlidir. Bir Google Dokümanlar dokümanı için 'text/markdown' ayrıca geçerlidir. |
Return
Blob
— Veriler bir blob olarak.
getBandings()
Bu e-tablodaki tüm şeritleri 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 kapsamlardan bir 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 piksel cinsinden genişliğini 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 kapsamlardan bir 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. İlgili içeriği oluşturmak için kullanılan
geçerli hücre, Google E-Tablolar kullanıcı arayüzünde odağın bulunduğu hücredir. Koyu renkle vurgulanmıştır
kenarlık. Hiçbir zaman birden fazla geçerli hücre yoktur. Kullanıcı bir veya daha fazla hücre aralığı seçtiğinde
seçimdeki hücrelerden biri geçerli hücredir.
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 kapsamlardan bir 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 A1 ile sınırlanan bir Aralık oluşturmaya eşdeğerdir. (Sheet.getLastColumn(), Sheet.getLastRow()).
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 kapsamlardan bir 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 kapsamlardan bir 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 kapsamlardan bir 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 programları.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 bir dizi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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ın yer aldığı bir dizi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Üst düzey e-tabloyla ilişkili 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 kapsamlardan bir 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 bir kullanıcı dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormUrl()
Yanıtları bu e-tabloya gönderen formun URL'sini veya aşağıdaki durumlarda null
değerini döndürür
bu e-tabloda ilişkilendirilmiş form yok. Bu e-tabloya birden fazla form yanıt gönderiyorsa
döndürülen form URL'si belirsiz. Alternatif olarak, sayfa başına form URL ilişkilendirmeleri
Sheet.getFormUrl()
yöntemi ile alını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 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 null
Bu e-tabloda ilişkilendirilmiş bir form yok.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFrozenRows()
Dondurulmuş satır 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 kapsamlardan bir 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, e-tablonun URL'sinden çıkarılabilir. Örneğin, URL'deki e-tablo kimliği https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 = "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 kılavuz üzeri 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[]
: Kılavuz üzeri görüntüler dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getIterativeCalculationConvergenceThreshold()
Yinelemeli hesaplama sırasında kullanılan eşik değerini döndürür. Birbirini izleyenlerin sonuçları daha az farklılık olursa 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
İçerik barındıran 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
İçerik barındıran 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 kapsamlardan bir 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 kapsamlardan bir 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 kapsamlardan bir 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 tüm adlandırılmış aralıkların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 kapsamlardan bir 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 kapsamlardan bir 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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi 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 korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange(a1Notation)
A1 gösteriminde veya R1C1 notasyonunda belirtilen aralığı 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 notasyonunda 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRangeByName(name)
Adlandırılmış bir aralık veya belirtilen ada sahip bir aralık bulunamazsa null
döndürür. Birden fazla
E-tablonun sayfalarında aynı aralık adını kullanıyorsa, sayfa adını fazladan olmadan
Tırnak işaretleri (ör. getRangeByName('TaxRates')
veya getRangeByName('Sheet Name!TaxRates')
, ancak getRangeByName('"Sheet
Name"!TaxRates')
değil).
// 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)
Belirtilen sayfadaki aralıkları temsil eden RangeList
koleksiyonunu döndürür
boş olmayan bir A1 gösterimleriyle veya R1C1 gösterimleriyle ilişkilendirilmelidir.
// 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österimi veya R1C1 gösteriminde belirtildiği gibi, 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRecalculationInterval()
Bu e-tablonun 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-tablonun hesaplama aralığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowHeight(rowPosition)
Verilen 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSelection()
E-tablodaki geçerli Selection
değerini döndürür.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
- geçerli seçim
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSheetByName(name)
Belirtilen ada sahip bir sayfa döndürür.
Birden fazla sayfa aynı ada sahipse en soldaki sayfa döndürülür. Şu durumda null
değerini döndürür:
belirtilen ada sahip bir sayfa yok.
// 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 adın bulunduğu 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, tek tip bir
Sayfa konumundan bağımsız olarak sayfa oluşturma zamanında atanan, artan tam sayı. Bu
değeri, Sheet
örneği yerine gridId
parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
gibi yöntemlerle birlikte kullanışlıdır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
- E-tabloya özgü sayfa kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 kapsamlardan bir 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. A -1 satır veya sütun konumu olarak verilen değer, en son satırı veya sütunu almaya eşdeğerdir yer alır.
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 bir değer dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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 sayfalardan oluşan 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 kapsamlardan bir 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 tema uygulanmadıysa null
değerini döndürür.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Return
SpreadsheetTheme
— Geçerli olarak uygulanan tema.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getSpreadsheetTimeZone()
E-tabloya ilişkin 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
— "long" olarak belirtilen saat dilimi biçimindedir (örneğin, "Amerika/New_York",
(Joda.org) tarafından sunulmaktadır.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getUrl()
Belirli bir e-tablonun URL'sini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Return
String
— Belirli bir e-tablonun URL'si.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getViewers()
Bu Spreadsheet
için görüntüleyenlerin ve yorumcuları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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideColumn(column)
Verilen 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hideRow(row)
Belirtilen 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnAfter(afterPosition)
Verilen 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 | Kendisinden sonra yeni sütunun ekleneceği sütun. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnBefore(beforePosition)
Verilen 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 | Kendisine yeni sütunun eklenmesi gereken sütun. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsAfter(afterPosition, howMany)
Verilen sütun konumundan sonra belirli 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 | Kendisinden sonra yeni sütunun ekleneceği sütun. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertColumnsBefore(beforePosition, howMany)
Belirtilen sütun konumundan önce bir 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 | Kendisine yeni sütunun eklenmesi gereken sütun. |
howMany | Integer | Eklenecek sütun sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertDataSourceSheet(spec)
E-tabloya yeni bir DataSourceSheet
ekler ve veri yürütmeyi başlatır. Kullanıcı
Bu durumda yeni sayfa da etkin sayfa olur.
Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanma
türü.
// 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(blobSource, column, row)
Belirli bir satır ve sütundaki belgeye 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);
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 kapsamlardan bir 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)
Belirli bir satır ve sütundaki belgeye resim olarak Spreadsheet
ekler.
piksel uzaklığı. Resim boyutu blob içeriklerinden alınır. Desteklenen maksimum blob
boyut 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 (piksel cinsinden). |
offsetY | Integer | Hücre köşesinden dikey uzaklık (piksel cinsinden). |
Return
OverGridImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertImage(url, column, row)
Dokümana belirli bir satır ve sütundaki 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 kapsamlardan bir 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)
Belirli bir satır ve sütunda dokümana bir resim ekler. Bu resim belirli bir piksel uzaklığıyla gösterilir.
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 | Resmin URL'si. |
column | Integer | Sütun konumu. |
row | Integer | Satır konumu. |
offsetX | Integer | Hücre köşesinden yatay uzaklık (piksel cinsinden). |
offsetY | Integer | Hücre köşesinden dikey uzaklık (piksel cinsinden). |
Return
OverGridImage
— Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowAfter(afterPosition)
Verilen 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 | Kendisinden sonra yeni satırın ekleneceği satır. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowBefore(beforePosition)
Verilen 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 | Kendisine yeni satırın eklenmesi gereken satır. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsAfter(afterPosition, howMany)
Belirtilen satır konumundan sonra birkaç 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
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertRowsBefore(beforePosition, howMany)
Verilen satır konumundan önce birkaç 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 | Kendisine yeni satırların ekleneceği satır. |
howMany | Integer | Eklenecek satır sayısı. |
Return
Sheet
— e-tablo, yöntem zinciri için kullanışlıdır
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet()
Varsayılan sayfa adını kullanarak e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfada.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex)
Belirtilen dizindeki e-tabloya yeni bir sayfa ekler. Yeni sayfa, etkin sayfasına gitmelidir.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheetIndex | Integer | Yeni oluşturulan e-tablonun dizini. Bir sayfayı ilk sayfa olarak eklemek için değeri 0 olarak ayarlayın. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetIndex, options)
Belirtilen dizindeki e-tabloya yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenlerdir. 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 e-tablonun dizini. Bir sayfayı ilk sayfa olarak eklemek için değeri 0 olarak ayarlayın. |
options | Object | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler tıklayın. E-tablo şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(options)
Varsayılan sayfa adını ve isteğe bağlı gelişmişyi kullanarak e-tabloya yeni bir sayfa ekler bağımsız değişkenlerdir. 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 | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri aşağıda listelenmiştir. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler tıklayın. E-tablo ş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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName)
E-tabloya verilen ada yeni bir sayfa ekler. Yeni sayfa, etkin sayfasına gitmelidir.
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, sheetIndex)
E-tabloya, belirtilen dizinde belirtilen ada sahip 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 e-tablonun dizini. Bir sayfayı ilk sayfa olarak eklemek için değeri 0 olarak ayarlayın. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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. 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ı ilk sayfa olarak eklemek için 0 olarak ayarlayın. |
options | Object | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler tıklayın. E-tablo şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheet(sheetName, options)
E-tabloya verilen ada sahip yeni bir sayfa ekler ve isteğe bağlı olarak gelişmiş bağımsız değişkenlerdir. 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ı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesindeki tüm veriler tıklayın. E-tablo şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertSheetWithDataSourceTable(spec)
E-tabloya yeni bir sayfa ekler, DataSourceTable
Veri kaynağı spesifikasyonunu içeren tüm sayfayı açar ve verileri yürütmeye başlar. Yan olarak
yeni sayfayı etkin sayfa haline getirir.
Veri kaynağı türü etkin değilse istisna atar. Belirli bir veri kaynağına yönelik veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanma
türü.
// 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 kapsamlardan bir 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
, gizliyse false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları, aşağıdaki kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isIterativeCalculationEnabled()
Bu e-tabloda yinelemeli hesaplamanın etkinleştirilip etkinleştirilmediğini 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByFilter(rowPosition)
Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isRowHiddenByUser(rowPosition)
Belirtilen 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 kapsamlardan bir 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 belirtilen konuma taşır. Şu durumda bir istisna atar: konum negatif veya sayfa sayısından büyük.
// 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 kapsamlardan bir 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
e-tablosu oluşturur ve sağlanan grafiği bu sayfaya 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
refreshAllDataSources()
Geçersiz olanı atlayarak desteklenen tüm veri kaynaklarını ve bağlı veri kaynağı nesnelerini yeniler veri kaynağı nesneleridir.
Şunun için veri yürütülmesini etkinleştirmek için SpreadsheetApp#enable...Execution()
yöntemlerini kullanın:
belirli bir veri kaynağı türü.
// 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 kapsamlardan bir veya daha fazlasıyla yetkilendirme gerektirir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeEditor(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyenler listesinden kaldırır. Bu yöntem
Şu özelliklere sahip bir kullanıcı sınıfına aitse, kullanıcıların Spreadsheet
öğesine erişmesini engelle:
genel erişim (örneğin, Spreadsheet
, kullanıcının tümüyle paylaşılıyorsa)
veya Spreadsheet
, kullanıcının erişebileceği bir ortak drive'da bulunuyorsa.
Bu işlem, Drive dosyaları için kullanıcıyı, görüntüleyenler listesinden de kaldırır.