E-tablo sayfalarına erişebilir ve bu sayfaları değiştirebilirsiniz. Sık kullanılan işlemler arasında bir e-tablonun adını değiştirme ve e-tablodaki aralık nesnelerine erişme yer alır.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | Sheet | Bu sayfayı etkinleştirir. |
add | Sheet | Belirtilen anahtarla geliştirici meta verilerini sayfaya ekler. |
add | Sheet | E-tabloya, belirtilen anahtar ve görünürlükle geliştirici meta verileri ekler. |
add | Sheet | E-tabloya, belirtilen anahtar ve değere sahip geliştirici meta verilerini ekler. |
add | Sheet | Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini sayfaya ekler. |
append | Sheet | Sayfadaki geçerli veri bölgesinin altına bir satır ekler. |
as | Data | Sayfa Sheet türüne sahipse sayfayı Data olarak, aksi takdirde null olarak döndürür. |
auto | Sheet | Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar. |
auto | Sheet | Belirtilen sütun konumundan itibaren tüm sütunların genişliğini, içeriklerine sığacak şekilde ayarlar. |
auto | Sheet | Belirtilen satır konumundan itibaren tüm satırların yüksekliğini, içeriklerine sığacak şekilde ayarlar. |
clear() | Sheet | Sayfayı içerik ve biçimlendirme bilgilerinden temizler. |
clear(options) | Sheet | Belirtilen gelişmiş seçeneklerle belirtildiği şekilde sayfayı içeriklerden ve/veya biçiminden temizler. |
clear | void | E-tablodaki tüm koşullu biçimlendirme kurallarını kaldırır. |
clear | Sheet | İçerik sayfasını temizler ancak biçimlendirme bilgilerini korur. |
clear | Sheet | İçeriği koruyarak sayfayı biçimlendirmeden temizler. |
clear | Sheet | Sayfayı tüm notlardan temizler. |
collapse | Sheet | Sayfadaki tüm sütun gruplarını daraltır. |
collapse | Sheet | Sayfadaki tüm satır gruplarını daraltır. |
copy | Sheet | Sayfayı, kaynakla aynı e-tablo da dahil olmak üzere belirli bir e-tabloya kopyalar. |
create | Developer | Bu sayfanın kapsamında geliştirici meta verilerini bulmak için bir Developer döndürür. |
create | Text | E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirebilir. |
delete | Sheet | Belirtilen sütun konumundaki sütunu siler. |
delete | void | Belirtilen sütun konumundan itibaren belirli sayıda sütunu siler. |
delete | Sheet | Belirtilen satır konumundaki satırı siler. |
delete | void | Belirtilen satır konumundan itibaren belirli sayıda satırı siler. |
expand | Sheet | Sayfadaki tüm sütun gruplarını genişletir. |
expand | Sheet | Sayfadaki tüm satır gruplarını genişletir. |
expand | Sheet | Belirtilen derinliğe kadar tüm sütun gruplarını genişletir ve diğer tüm grupları daraltır. |
expand | Sheet | Belirtilen derinliğe kadar tüm satır gruplarını genişletir ve diğer tüm grupları daraltır. |
get | Range | Bu sayfadaki etkin hücreyi döndürür. |
get | Range | Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null değerini döndürür. |
get | Range | Etkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null değerini döndürür. |
get | Banding[] | Bu sayfadaki tüm bantları döndürür. |
get | Embedded | Bu sayfadaki grafik dizisini döndürür. |
get | Group | Belirtilen dizinde ve grup derinliğindeki sütun grubunu döndürür. |
get | Group | Sayfadaki tüm sütun grupları için Group değerini döndürür. |
get | Integer | Belirtilen dizindeki sütunun grup derinliğini döndürür. |
get | Integer | Belirtilen sütunun piksel cinsinden genişliğini alır. |
get | Conditional | Bu e-tablodaki tüm koşullu biçimlendirme kurallarını alın. |
get | Range | Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null değerini döndürür. |
get | Range | Verilerin bulunduğu boyutlara karşılık gelen bir Range döndürür. |
get | Data | Tüm veri kaynağı formüllerini alır. |
get | Data | Tüm veri kaynağı pivot tablolarını alır. |
get | Data | Tüm veri kaynağı tablolarını alır. |
get | Developer | Bu sayfayla ilişkili tüm geliştirici meta verilerini alın. |
get | Drawing[] | Sayfadaki çizimler dizisini döndürür. |
get | Filter | Bu sayfadaki filtreyi veya filtre yoksa null değerini döndürür. |
get | String | Yanıtlarını bu sayfaya gönderen formun URL'sini döndürür veya bu sayfayla ilişkili bir form yoksa null değerini döndürür. |
get | Integer | Dondurulmuş sütun sayısını döndürür. |
get | Integer | Dondurulmuş satır sayısını döndürür. |
get | Over | Sayfadaki tüm ızgara dışı resimleri döndürür. |
get | Integer | Sayfanın, üst e-tablosundaki konumunu alır. |
get | Integer | İçeriği olan son sütunun konumunu döndürür. |
get | Integer | İçeriği olan son satırın konumunu döndürür. |
get | Integer | İçeriğe bakılmaksızın sayfadaki mevcut sütun sayısını döndürür. |
get | Integer | İçeriğe bakılmaksızın sayfadaki mevcut satır sayısını döndürür. |
get | String | E-tablonun adını döndürür. |
get | Named | Bu sayfadaki tüm adlandırılmış aralıkları alır. |
get | Spreadsheet | Bu sayfayı içeren Spreadsheet öğesini döndürür. |
get | Pivot | Bu sayfadaki tüm pivot tabloları döndürür. |
get | Protection[] | Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek öğeli bir dizi alır. |
get | Range | Belirtilen koordinatlarda sol üst hücreyi içeren aralığı döndürür. |
get | Range | Belirtilen koordinatlarda sol üst hücreyi ve belirtilen satır sayısını içeren aralığı döndürür. |
get | Range | Belirli satır ve sütun sayısına sahip, belirli koordinatlarda sol üst hücreyi içeren aralığı döndürür. |
get | Range | A1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür. |
get | Range | Boş olmayan bir A1 veya R1C1 notasyonu listesi tarafından belirtilen aynı sayfadaki aralıkları temsil eden Range koleksiyonunu döndürür. |
get | Group | Belirtilen dizinde ve grup derinliğindeki satır grubunu döndürür. |
get | Group | E-tablodaki tüm satır grupları için Group değerini döndürür. |
get | Integer | Belirtilen dizindeki satırın grup derinliğini döndürür. |
get | Integer | Belirtilen satırın piksel cinsinden yüksekliğini alır. |
get | Selection | E-tablodaki geçerli Selection değerini döndürür. |
get | Integer | Bu nesne tarafından temsil edilen sayfanın kimliğini döndürür. |
get | String | E-tablo adını döndürür. |
get | Object[][] | Belirtilen koordinatlardan başlayarak bu aralık için dikdörtgen bir değer ızgarası döndürür. |
get | Slicer[] | Sayfadaki bir dilimleyici dizisi döndürür. |
get | Color | Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null değerini alır. |
get | Sheet | E-tablonun türünü döndürür. |
has | Boolean | Sayfanın ızgara çizgileri gizliyse true , aksi takdirde false döndürülür. |
hide | void | Belirli aralıktaki sütunu veya sütunları gizler. |
hide | void | Belirtilen dizindeki tek bir sütunu gizler. |
hide | void | Belirtilen dizinden itibaren bir veya daha fazla sütunu gizler. |
hide | void | Belirtilen aralıktaki satırları gizler. |
hide | void | Belirtilen dizindeki satırı gizler. |
hide | void | Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler. |
hide | Sheet | Bu sayfayı gizler. |
insert | void | Bu sayfaya yeni bir grafik ekler. |
insert | Sheet | Belirtilen sütun konumundan sonra bir sütun ekler. |
insert | Sheet | Belirtilen sütun konumundan önce bir sütun ekler. |
insert | void | Sayfada belirtilen konuma boş bir sütun ekler. |
insert | void | Belirtilen konumdan itibaren bir sayfada bir veya daha fazla art arda boş sütun ekler. |
insert | Sheet | Belirtilen sütun konumundan sonra belirli sayıda sütun ekler. |
insert | Sheet | Belirtilen sütun konumundan önce bir dizi sütun ekler. |
insert | Over | Dokümana belirli bir satır ve sütunda resim olarak Blob ekler. |
insert | Over | Belirli bir satır ve sütuna, piksel kaydırması ile dokümana resim olarak bir Blob ekler. |
insert | Over | Dokümana belirli bir satır ve sütuna resim ekler. |
insert | Over | Dokümana, belirli bir satır ve sütunda piksel kaydırmayla bir resim ekler. |
insert | Sheet | Belirtilen satır konumundan sonra bir satır ekler. |
insert | Sheet | Belirtilen satır konumundan önce bir satır ekler. |
insert | void | Belirtilen konumda bir sayfaya boş bir satır ekler. |
insert | void | Belirtilen konumdan itibaren bir sayfaya art arda bir veya daha fazla boş satır ekler. |
insert | Sheet | Belirtilen satır konumundan sonra bir dizi satır ekler. |
insert | Sheet | Belirtilen satır konumundan önce bir dizi satır ekler. |
insert | Slicer | Bu sayfaya yeni bir dilimleyici ekler. |
insert | Slicer | Bu sayfaya yeni bir dilimleyici ekler. |
is | Boolean | Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
is | Boolean | Bu sayfa düzeni sağdan sola ise true değerini döndürür. |
is | Boolean | Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür. |
is | Boolean | Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
is | Boolean | Sayfa şu anda gizliyse true değerini döndürür. |
move | void | Belirtilen aralık tarafından seçilen sütunları destination ile belirtilen konuma taşır. |
move | void | Belirtilen aralık tarafından seçilen satırları destination ile belirtilen konuma taşır. |
new | Embedded | Bu e-tablo için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür. |
protect() | Protection | İzin sahibi kullanıcılar dışındaki kullanıcıların sayfayı düzenlemesini engelleyebilecek bir nesne oluşturur. |
remove | void | Grafiği ana sayfadan kaldırır. |
set | Range | Belirtilen aralığı etkin sayfada active range olarak ayarlar. Bu aralığın sol üst hücresi current cell olur. |
set | Range | Belirtilen aralık listesini etkin sayfada active ranges olarak ayarlar. |
set | Range | Bu sayfa için etkin seçim bölgesini ayarlar. |
set | Range | Etkin seçimi A1 notasyonunda veya R1C1 notasyonunda belirtildiği şekilde ayarlar. |
set | Sheet | Sayfadaki sütun grubu denetimi açma/kapatma düğmesinin konumunu ayarlar. |
set | Sheet | Belirtilen sütunun genişliğini piksel cinsinden ayarlar. |
set | Sheet | Belirtilen sütunların genişliğini piksel cinsinden ayarlar. |
set | void | Sayfada şu anda mevcut olan tüm koşullu biçimlendirme kurallarını giriş kurallarıyla değiştirir. |
set | Range | Belirtilen hücreyi current cell olarak ayarlar. |
set | void | Belirli sayıda sütunu dondurur. |
set | void | Belirtilen sayıda satırı dondurur. |
set | Sheet | Sayfa kılavuz çizgilerini gizler veya gösterir. |
set | Sheet | E-tablo adını belirler. |
set | Sheet | Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırır. |
set | Sheet | Satır grubu denetimi açma/kapatma düğmesinin sayfadaki konumunu ayarlar. |
set | Sheet | Belirtilen satırın piksel cinsinden satır yüksekliğini ayarlar. |
set | Sheet | Belirtilen satırların piksel cinsinden yüksekliğini ayarlar. |
set | Sheet | Belirtilen satırların piksel cinsinden yüksekliğini ayarlar. |
set | Sheet | E-tablo sekmesi rengini ayarlar. |
set | Sheet | E-tablo sekmesi rengini ayarlar. |
show | void | Belirtilen dizindeki sütunu görünür hale getirir. |
show | void | Belirtilen dizinden itibaren bir veya daha fazla sütunu görünür hale getirir. |
show | void | Belirtilen dizindeki satırı görünür hale getirir. |
show | void | Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler. |
show | Sheet | E-tabloyu görünür yapar. |
sort(columnPosition) | Sheet | Bir sayfayı sütuna göre artan düzende sıralar. |
sort(columnPosition, ascending) | Sheet | Bir sayfayı sütuna göre sıralar. |
unhide | void | Belirtilen aralıktaki sütunu gösterir. |
unhide | void | Belirtilen aralıktaki satırı gösterir. |
update | void | Bu sayfadaki grafiği günceller. |
Ayrıntılı dokümanlar
activate()
Bu sayfayı etkinleştirir. E-tablonun kendisini değil, yalnızca üst öğenin etkin e-tabloyla ilgili fikrini değiştirir.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.activate();
Return
Sheet
: Yeni etkin sayfa.
add Developer Metadata(key)
Belirtilen anahtarla geliştirici meta verilerini sayfaya 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' to the developer metadata for the sheet. sheet.addDeveloperMetadata('NAME'); // Gets the updated metadata info and logs it to the console. console.log(sheet.getDeveloperMetadata()[0].getKey());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(key, visibility)
E-tabloya, belirtilen anahtar ve görünürlükle geliştirici meta verileri 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'NAME' and sets the developer metadata visibility to PROJECT // for the sheet. sheet.addDeveloperMetadata( 'NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT, ); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(key, value)
E-tabloya, belirtilen anahtar ve değere sahip geliştirici meta verilerini 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata for // the sheet. sheet.addDeveloperMetadata('COMPANY', 'TECH'); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
add Developer Metadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini sayfaya 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds the key 'COMPANY' with the value 'TECH' to the developer metadata and // sets the visibility to DOCUMENT for the sheet. sheet.addDeveloperMetadata( 'COMPANY', 'TECH', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT, ); // Gets the updated metadata info and logs it to the console. const developerMetaData = sheet.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
append Row(rowContents)
Sayfadaki geçerli veri bölgesinin altına bir satır ekler. Bir hücrenin içeriği =
ile başlıyorsa formül olarak yorumlanır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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 |
---|---|---|
row | Object[] | E-tablodaki son satırdan sonra eklenecek bir değer dizisi. |
Return
Sheet
: Yöntem zincirleme için yararlı olan sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
as Data Source Sheet()
Sayfa Sheet
türüne sahipse sayfayı Data
olarak, aksi takdirde null
olarak döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the data source sheet value if the sheet is of type // SpreadsheetApp.SheetType.DATASOURCE, otherwise this returns a null value. const dataSourceSheet = sheet.asDataSourceSheet(); // Gets the data source sheet value and logs it to the console. console.log(dataSourceSheet); console.log(sheet.getType().toString());
Return
Data
: Veri kaynağı sayfası.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
auto Resize Column(columnPosition)
Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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 |
---|---|---|
column | Integer | Yeniden boyutlandırılacak sütunun konumu. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
auto Resize Columns(startColumn, numColumns)
Belirtilen sütun konumundan itibaren tüm sütunların genişliğini, içeriklerine sığacak şekilde ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first 15 columns to a width that fits their text. sheet.autoResizeColumns(1, 15);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Otomatik olarak yeniden boyutlandırılacak başlangıç sütunu. |
num | Integer | Otomatik olarak yeniden boyutlandırılacak sütun sayısı. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
auto Resize Rows(startRow, numRows)
Belirtilen satır konumundan itibaren tüm satırların yüksekliğini içeriklerine sığacak şekilde ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first 15 rows to a height that fits their text. sheet.autoResizeRows(1, 15);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Otomatik olarak yeniden boyutlandırılacak başlangıç satırı. |
num | Integer | Otomatik olarak yeniden boyutlandırılacak satır sayısı. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Sayfayı içerik ve biçimlendirme bilgilerinden temizler.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.clear();
Return
Sheet
: Temizlenmiş sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Belirtilen gelişmiş seçeneklerle belirtildiği şekilde sayfayı içeriklerden ve/veya biçiminden temizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.clear({formatOnly: true, contentsOnly: true});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen gelişmiş seçenekleri içeren bir JavaScript haritası. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
contents | Boolean | İçeriğin temizlenip temizlenmeyeceği. |
format | Boolean | Biçimin temizlenip temizlenmeyeceği. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Conditional Format Rules()
E-tablodaki tüm koşullu biçimlendirme kurallarını kaldırır. Giriş olarak boş bir dizi ile set
işlevini çağırmaya eşdeğerdir.
const sheet = SpreadsheetApp.getActiveSheet(); sheet.clearConditionalFormatRules();
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Contents()
İçerik sayfasını temizler ancak biçimlendirme bilgilerini korur.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.clearContents();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Formats()
İçeriği koruyarak sayfayı biçimlendirmeden temizler.
Biçimlendirme, hücrelerin genişliği veya yüksekliği değil, verilerin "Biçim" menüsündeki seçeneklere göre nasıl biçimlendirildiğini ifade eder (ör. kalın, italik, koşullu biçimlendirme).
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.clearFormats();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear Notes()
Sayfayı tüm notlardan temizler.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.clearNotes();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapse All Column Groups()
Sayfadaki tüm sütun gruplarını daraltır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are collapsed. sheet.collapseAllColumnGroups();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapse All Row Groups()
Sayfadaki tüm satır gruplarını daraltır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are collapsed. sheet.collapseAllRowGroups();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(spreadsheet)
Sayfayı, kaynakla aynı e-tablo da dahil olmak üzere belirli bir e-tabloya kopyalar. Kopyalanan sayfanın adı "[orijinal ad] kopyası" olur.
const source = SpreadsheetApp.getActiveSpreadsheet(); const sheet = source.getSheets()[0]; const destination = SpreadsheetApp.openById('ID_GOES HERE'); sheet.copyTo(destination);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spreadsheet | Spreadsheet | Bu sayfanın kopyalanacağı e-tablo. Kaynakla aynı e-tablo olabilir. |
Return
Sheet
: Zincirleme için yeni e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Developer Metadata Finder()
Bu sayfanın kapsamında geliştirici meta verilerini bulmak için bir Developer
döndürür. Meta veriler, sayfanın kendisiyle veya sayfadaki bir satır, sütun ya da aralıkla ilişkilendirilmişse belirli bir sayfanın kapsamındadı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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Creates the developer metadata finder. const metadatafinder = sheet.createDeveloperMetadataFinder(); // Finds the metadata with value 'PARIS' and displays its key in the console. console.log(metadatafinder.withValue('PARIS').find()[0].getKey());
Return
Developer
: Bu sayfanın kapsamındaki meta verileri arayan bir geliştirici meta veri bulucusu.
create Text Finder(findText)
E-tablo için bir metin bulucu oluşturur. Bu metin bulucu, e-tablodaki metinleri bulup değiştirebilir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Creates a text finder. const textFinder = sheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the sheet. const firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. const numOccurrencesReplaced = firstOccurrence.replaceWith('cat');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
find | String | Aranacak metin. |
Return
Text
: E-tablonun Text
değeri.
delete Column(columnPosition)
Belirtilen sütun konumundaki sütunu siler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sütunun konumu (ilk sütun için 1'den başlar). |
Return
Sheet
: yöntem zincirleme için yararlı olan sayfa
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
delete Columns(columnPosition, howMany)
Belirtilen sütun konumundan itibaren belirli sayıda sütunu siler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Silecek ilk sütunun konumu. |
how | Integer | Sililecek sütunların sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
delete Row(rowPosition)
Belirtilen satır konumundaki satırı siler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Satırın konumu (ilk satır için 1'den başlar). |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
delete Rows(rowPosition, howMany)
Belirtilen satır konumundan itibaren belirli sayıda satırı siler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Silecek ilk satırın konumu. |
how | Integer | Silinecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand All Column Groups()
Sayfadaki tüm sütun gruplarını genişletir. Bu yöntem için en az bir sütun grubu gerekir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups on the sheet are expanded. sheet.expandAllColumnGroups();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand All Row Groups()
Sayfadaki tüm satır gruplarını genişletir. Bu yöntem için en az bir satır grubu gerekir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups on the sheet are expanded. sheet.expandAllRowGroups();
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand Column Groups Up To Depth(groupDepth)
Belirtilen derinliğe kadar tüm sütun gruplarını genişletir ve diğer tüm grupları daraltır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All column groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandColumnGroupsUpToDepth(2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
group | Integer | Sütun gruplarının genişletileceği grup derinliği. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand Row Groups Up To Depth(groupDepth)
Belirtilen derinliğe kadar tüm satır gruplarını genişletir ve diğer tüm grupları daraltır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // All row groups of depth 2 and lower are expanded, and groups with depth // 3 and higher are collapsed. sheet.expandRowGroupsUpToDepth(2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
group | Integer | Satır gruplarının genişletileceği grup derinliği. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Active Cell()
Bu sayfadaki etkin hücreyi döndürür.
Not: Vurgulanan mevcut hücreyi döndüren get
işlevinin kullanılması tercih edilir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Returns the active cell const cell = sheet.getActiveCell();
Return
Range
: Geçerli etkin hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Active Range()
Etkin sayfadaki seçili aralığı veya etkin bir aralık yoksa null
değerini döndürür. Birden fazla aralık seçilirse bu yöntem yalnızca son seçilen aralığı döndürür.
"Etkin aralık" terimi, kullanıcının etkin sayfada seçtiği aralığı ifade eder ancak özel işlevlerde etkin olarak yeniden hesaplanan hücreyi ifade eder.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); const activeRange = sheet.getActiveRange();
Return
Range
: Etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
get Active Range List()
Etkin e-tablodaki etkin aralıkların listesini veya etkin aralık yoksa null
değerini döndürür.
Tek bir aralık seçiliyse bu, get
çağrısı gibi davranır.
const sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. const activeRangeList = sheet.getActiveRangeList();
Return
Range
: Etkin aralıkların listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Aşağıdaki kaynakları da incelemenizi öneririz:
get Bandings()
Bu sayfadaki tüm bantları döndürü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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the banding info for the sheet. const bandings = sheet.getBandings(); // Gets info on the bandings' second row color and logs it to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Return
Banding[]
: Bu e-tablodaki tüm bantlar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Charts()
Bu sayfadaki grafik dizisini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const charts = sheet.getCharts(); for (const i in charts) { const chart = charts[i]; // Do something with the chart }
Return
Embedded
: Grafik dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column Group(columnIndex, groupDepth)
Belirtilen dizinde ve grup derinliğindeki sütun grubunu döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at column 2 and has a depth of 1, or // null if the group doesn’t exist. const columnGroup = sheet.getColumnGroup(2, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Grup denetimi açma/kapatma düğmesinin sütun dizini veya grup içindeki bir dizin. |
group | Integer | Grubun derinliği. |
Return
Group
: Kontrol dizini ve derinliğindeki sütun grubudur veya grup mevcut değilse istisna atar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column Group Control Position()
Sayfadaki tüm sütun grupları için Group
değerini döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the column grouping control toggle is // shown after the group. const columnGroupControlPosition = sheet.getColumnGroupControlPosition();
Return
Group
: Sütun gruplandırma kontrol düğmesi bu sayfadaki grubun ardından gösteriliyorsa true
, aksi takdirde false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column Group Depth(columnIndex)
Belirtilen dizindeki sütunun grup derinliğini döndürür.
Grup derinliği, sütunla kaç grubun örtüştüğünü gösterir. Bu değer sıfır ile sekiz arasında olabilir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over columns 1 through 3 const groupDepth = sheet.getColumnGroupDepth(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sütunun dizini. |
Return
Integer
: Belirtilen dizindeki sütunun grup derinliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column Width(columnPosition)
Belirtilen sütunun piksel cinsinden genişliğini alır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | İncelenecek sütunun konumu. |
Return
Integer
: sütun genişliği (piksel cinsinden)
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Conditional Format Rules()
Bu e-tablodaki tüm koşullu biçimlendirme kurallarını alın.
// Logs the conditional format rules in a sheet. const rules = SpreadsheetApp.getActiveSheet().getConditionalFormatRules(); for (let i = 0; i < rules.length; i++) { const rule = rules[i]; Logger.log(rule); }
Return
Conditional
: Sayfadaki tüm kuralların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Current Cell()
Etkin sayfadaki geçerli hücreyi veya geçerli hücre yoksa null
değerini döndürür. Mevcut hücre, Google E-Tablolar kullanıcı arayüzünde odak noktasında olan ve koyu kenarlıkla vurgulanan hücredir. 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ücre olur.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. const currentCell = sheet.getCurrentCell();
Return
Range
: Geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Range()
Verilerin bulunduğu boyutlara karşılık gelen bir Range
döndürür.
Bu, işlevsel olarak A1 ile (Sayfa.SonSütunu(), Sayfa.SonSatırı()) arasında sınırlanmış bir aralık oluşturmaya eşdeğerdir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This represents ALL the data const range = sheet.getDataRange(); const values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (let i = 0; i < values.length; i++) { let row = ''; for (let 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 verilerden oluşan bir aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Formulas()
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
Data
: Veri kaynağı formüllerinin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Pivot Tables()
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
Data
: Veri kaynağı pivot tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Tables()
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
Data
: Veri kaynağı tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Developer Metadata()
Bu sayfayla ilişkili tüm geliştirici meta verilerini alın.
// 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 a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Adds developer metadata for testing. sheet.addDeveloperMetadata('CITY', 'PARIS'); // Gets all the developer metadata for the sheet. const developerMetaDataList = sheet.getDeveloperMetadata(); // Logs the developer metadata to the console. for (const developerMetaData of developerMetaDataList) { console.log(developerMetaData.getKey()); }
Return
Developer
: Bu sayfayla ilişkili geliştirici meta verileri.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Drawings()
Sayfadaki çizimler dizisini döndürü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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the drawings from the sheet. const allDrawings = sheet.getDrawings(); // Logs the number of drawings present on the sheet. console.log(allDrawings.length);
Return
Drawing[]
: Bu sayfadaki çizimlerin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Filter()
Bu sayfadaki filtreyi veya filtre yoksa null
değerini döndürür.
// Gets the filter on the active sheet. const ss = SpreadsheetApp.getActiveSheet(); const filter = ss.getFilter();
Return
Filter
: Filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Form Url()
Yanıtlarını bu sayfaya gönderen formun URL'sini döndürür veya bu sayfayla ilişkili bir form yoksa null
değerini döndürür. Kullanıcının e-tabloyu düzenleme izni yoksa istisna oluşturur.
const sheet = SpreadsheetApp.getActiveSheet(); const url = sheet.getFormUrl();
Return
String
: Yanıtlarını bu sayfaya yerleştiren formun URL'si veya bu sayfayla ilişkili bir form yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Frozen Columns()
Dondurulmuş sütun sayısını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Frozen Rows()
Dondurulmuş satır sayısını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log('Number of frozen rows: %s', sheet.getFrozenRows());
Return
Integer
: Dondurulmuş satır sayısı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Images()
Sayfadaki tüm ızgara dışı 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
Over
: Kılavuz üzeri resim dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Index()
Sayfanın, üst e-tablosundaki konumunu alır. 1'den başlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); // Note that the JavaScript index is 0, but this logs 1 const sheet = ss.getSheets()[0]; // ... because spreadsheets are 1-indexed Logger.log(sheet.getIndex());
Return
Integer
: Sayfanın, üst e-tablosundaki konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Last Column()
İçeriği olan son sütunun konumunu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet const lastRow = sheet.getLastRow(); const lastColumn = sheet.getLastColumn(); const lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: E-tablonun içerik içeren son sütunu
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Last Row()
İçeriği olan son satırın konumunu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet const lastRow = sheet.getLastRow(); const lastColumn = sheet.getLastColumn(); const lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: E-tablonun içerik içeren son satırı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Max Columns()
İçeriğe bakılmaksızın sayfadaki mevcut sütun sayısını döndürür.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); Logger.log(first.getMaxColumns());
Return
Integer
: E-tablonun maksimum genişliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Max Rows()
İçeriğe bakılmaksızın sayfadaki mevcut satır sayısını döndürür.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); Logger.log(first.getMaxRows());
Return
Integer
: E-tablonun maksimum yüksekliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Name()
E-tablonun adını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getName());
Return
String
: E-tablonun adı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Named Ranges()
Bu sayfadaki tüm adlandırılmış aralıkları alır.
// The code below logs the name of the first named range. const namedRanges = SpreadsheetApp.getActiveSheet().getNamedRanges(); if (namedRanges.length > 1) { Logger.log(namedRanges[0].getName()); }
Return
Named
: Sayfadaki tüm adlandırılmış aralıkların dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Parent()
Bu sayfayı içeren Spreadsheet
değerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // parent is identical to ss const parent = sheet.getParent();
Return
Spreadsheet
: Ana e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Pivot Tables()
Bu sayfadaki tüm pivot tabloları döndürü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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all the pivot table info for the sheet. const pivotTables = sheet.getPivotTables(); // Logs the pivot tables to the console. for (const pivotTable of pivotTables) { console.log(pivotTable.getSourceDataRange().getValues()); }
Return
Pivot
: Bu sayfada bulunan pivot tablolar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Protections(type)
Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek öğeli bir dizi alır.
// Remove all range protections in the spreadsheet that the user has permission // to edit. const sheet = SpreadsheetApp.getActiveSheet(); const protections = sheet.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (let i = 0; i < protections.length; i++) { const protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove sheet protection from the active sheet, if the user has permission to // edit it. const sheet = SpreadsheetApp.getActiveSheet(); const protection = sheet.getProtections(SpreadsheetApp.ProtectionType.SHEET)[0]; if (protection?.canEdit()) { protection.remove(); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
type | Protection | Korunan alanın türü (Spreadsheet veya Spreadsheet ). |
Return
Protection[]
: Sayfadaki tüm korumalı aralıkları temsil eden bir nesne dizisi veya sayfadaki korumayı temsil eden tek bir öğe dizisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range(row, column)
Belirtilen koordinatlarda sol üst hücrenin bulunduğu aralığı döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Passing only two arguments returns a "range" with a single cell. const range = sheet.getRange(1, 1); const values = range.getValues(); Logger.log(values[0][0]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Döndürülecek hücrenin satır dizini. Satır dizine ekleme 1 ile başlar. |
column | Integer | Döndürülecek hücrenin sütun dizini. Sütun dizini 1 ile başlar. |
Return
Range
: Yalnızca bu hücreyi içeren bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range(row, column, numRows)
Belirtilen koordinatlarda sol üst hücreyi ve belirtilen satır sayısını içeren aralığı döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // When the "numRows" argument is used, only a single column of data is // returned. const range = sheet.getRange(1, 1, 3); const values = range.getValues(); // Prints 3 values from the first column, starting from row 1. for (const row in values) { for (const col in values[row]) { Logger.log(values[row][col]); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın başlangıç satır dizini; satır dizine ekleme 1 ile başlar. |
column | Integer | Aralığın sütun dizini. Sütun dizini 1 ile başlar. |
num | Integer | Döndürülecek satır sayısı. |
Return
Range
: Belirtilen satır sayısına sahip tek bir veri sütunu içeren bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range(row, column, numRows, numColumns)
Belirli satır ve sütun sayısına sahip, belirli koordinatlarda sol üst hücreyi içeren aralığı döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange(1, 1, 3, 3); const values = range.getValues(); // Print values from a 3x3 box. for (const row in values) { for (const col in values[row]) { Logger.log(values[row][col]); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın başlangıç satır dizini; satır dizine ekleme 1 ile başlar. |
column | Integer | Aralığın başlangıç sütun dizini. Sütun dizine ekleme 1 ile başlar. |
num | Integer | Döndürülecek satır sayısı. |
num | Integer | Döndürülecek sütun sayısı. |
Return
Range
: Belirtilen alana karşılık gelen bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range(a1Notation)
A1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür.
// Get a range A1:D4 on sheet titled "Invoices" const ss = SpreadsheetApp.getActiveSpreadsheet(); const range = ss.getRange('Invoices!A1:D4'); // Get cell A1 on the first sheet const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 veya R1C1 gösterimiyle belirtilen, döndürülecek aralık. |
Return
Range
: Belirtilen konumdaki aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Range List(a1Notations)
Boş olmayan bir A1 veya R1C1 notasyonu listesi tarafından belirtilen aynı sayfadaki aralıkları temsil eden Range
koleksiyonunu döndürür.
// Get a list of ranges A1:D4, F1:H4. const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); const rangeList = sheet.getRangeList(['A1:D4', 'F1:H4']);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notations | String[] | A1 veya R1C1 notasyonunda belirtildiği gibi döndürülecek aralıkların listesi. |
Return
Range
: Belirtilen konumdaki aralık listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Group(rowIndex, groupDepth)
Belirtilen dizinde ve grup derinliğindeki satır grubunu döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Returns the group whose control index is at row 2 and has a depth of 1, or // null if the group doesn’t exist. const rowGroup = sheet.getRowGroup(2, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Grup denetimi açma/kapatma düğmesinin satır dizini veya grup içindeki bir dizin. |
group | Integer | Grubun derinliği. |
Return
Group
: Kontrol dizini ve derinliğindeki satır grubudur veya grup mevcut değilse istisna atar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Group Control Position()
Sayfadaki tüm satır grupları için Group
değerini döndürür.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // GroupControlTogglePosition.AFTER if the row grouping control toggle is shown // after the group. const rowGroupControlPosition = sheet.getRowGroupControlPosition();
Return
Group
: Satır gruplandırma kontrol düğmesi bu sayfadaki grubun ardından gösteriliyorsa true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Group Depth(rowIndex)
Belirtilen dizindeki satırın grup derinliğini döndürür.
Grup derinliği, satırla kaç grubun örtüştüğünü gösterir. Bu değer sıfır ile sekiz arasında olabilir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // 1 if there is a group over rows 1 through 3 const groupDepth = sheet.getRowGroupDepth(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Satırın dizini. |
Return
Integer
: Belirtilen dizindeki satırın grup derinliği.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Height(rowPosition)
Belirtilen satırın piksel cinsinden yüksekliğini alır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | İncelenecek satırın konumu. |
Return
Integer
: piksel cinsinden satır yüksekliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Selection()
E-tablodaki geçerli Selection
değerini döndürür.
const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); const currentCell = selection.getCurrentCell();
Return
Selection
: Geçerli seçim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sheet Id()
Bu nesne tarafından temsil edilen sayfanın kimliğini döndürür.
Bu, e-tabloya özgü olan sayfanın kimliğidir. Kimlik, e-tablo oluşturulurken atanan ve e-tablo konumundan bağımsız olan monoton olarak artan bir tam sayıdır. Bu, Sheet
örneği yerine grid
parametresi alan Range.copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
gibi yöntemlerle birlikte kullanıldığında faydalıdır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
: E-tabloya özgü sayfa kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sheet Name()
E-tablo adını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Return
String
: Sayfanın adı
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sheet Values(startRow, startColumn, numRows, numColumns)
Belirtilen koordinatlardan başlayarak bu aralık için dikdörtgen değer ızgarasına döndürür. Satır veya sütun konumu olarak -1 değeri verildiğinde, sayfadaki verileri içeren en son satır veya sütun elde edilir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The two samples below produce the same output let values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); const range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Başlangıç satırının konumu. |
start | Integer | Başlangıç sütununun konumu. |
num | Integer | Değerlerinin döndürüleceği satır sayısı. |
num | Integer | Değerlerinin döndürüleceği sütun sayısı. |
Return
Object[][]
: iki boyutlu bir değer dizisi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Slicers()
Sayfadaki bir dilimleyici dizisi döndürü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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets all slicers in the spreadsheet. const slicers = sheet.getSlicers(); // Logs the slicer titles to the console. for (const slicer of slicers) { console.log(slicer.getTitle()); }
Return
Slicer[]
: Bu sayfadaki dilimleyicilerin listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Tab Color Object()
Sayfa sekmesi rengini veya sayfa sekmesinde renk yoksa null
değerini alır.
// This example assumes there is a sheet named "Sheet1" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('Sheet1'); const color = first.getTabColorObject();
Return
Color
: Sayfa sekmesi rengi veya sayfa sekmesinde renk yoksa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Type()
Sayfanın türünü döndürür.
E-tablonun varsayılan türü Sheet
'tir. Embedded
gibi tek bir yerleştirilmiş nesne içeren bir sayfa Sheet
sayfasıdır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; Logger.log(sheet.getType());
Return
Sheet
: E-tablonun türü.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
has Hidden Gridlines()
Sayfanın ızgara çizgileri gizliyse true
, aksi takdirde false
döndürülür.
Kılavuz çizgileri varsayılan olarak görünür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if the spreadsheet has hidden gridelines and logs the result to the // console. console.log(sheet.hasHiddenGridlines());
Return
Boolean
: Kılavuz çizgileri gizliyse true
, aksi takdirde false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Column(column)
Belirli aralıktaki sütunu veya sütunları gizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange('A1'); sheet.hideColumn(range); // This hides the first 3 columns 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Columns(columnIndex)
Belirtilen dizindeki tek bir sütunu gizler. Bu yöntem için 1 dizini kullanın.
Dizin kullanarak birden fazla sütunu gizlemek için hide
simgesini kullanın.
Bir aralığı kullanarak birden fazla sütunu gizlemek için hide
simgesini kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Hides the first column sheet.hideColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Gizlenecek sütunun dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Columns(columnIndex, numColumns)
Belirtilen dizinden itibaren bir veya daha fazla sütunu gizler. Bu yöntem için 1 dizini kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Hides the first three columns sheet.hideColumns(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Gizlenecek sütunların başlangıç dizini. |
num | Integer | Gizlenecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Row(row)
Belirtilen aralıktaki satırları gizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This hides the first row const 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ının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Rows(rowIndex)
Belirtilen dizindeki satırı gizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Hides the first row sheet.hideRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Gizlenecek satırın dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Rows(rowIndex, numRows)
Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Hides the first three rows sheet.hideRows(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Gizlenecek satırların başlangıç dizini. |
num | Integer | Gizlenecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
hide Sheet()
Bu sayfayı gizler. E-tablo zaten gizliyse hiçbir etkisi olmaz. Bu yöntem, yalnızca görünen sayfada çağrılırsa istisna oluşturur.
const sheet = SpreadsheetApp.getActiveSheet(); sheet.hideSheet();
Return
Sheet
: Geçerli sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Chart(chart)
Bu sayfaya yeni bir grafik ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This creates a simple bar chart from the first three rows // of the first two columns of the spreadsheet const chart = sheet.newChart() .setChartType(Charts.ChartType.BAR) .addRange(sheet.getRange('A1:B4')) .setPosition(5, 5, 0, 0) .setOption('title', 'Dynamic Chart') .build(); sheet.insertChart(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | Embedded | Eklenecek grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Column After(afterPosition)
Belirtilen sütun konumundan sonra bir sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
after | Integer | Yeni sütunun ekleneceği sütun. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Column Before(beforePosition)
Belirtilen sütun konumundan önce bir sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
before | Integer | Yeni sütunun ekleneceği sütun. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Columns(columnIndex)
Sayfada belirtilen konuma boş bir sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Shifts all columns by one sheet.insertColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sütunun nereye ekleneceğini belirten dizin. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Columns(columnIndex, numColumns)
Belirtilen konumdan itibaren bir sayfada bir veya daha fazla art arda boş sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Shifts all columns by three sheet.insertColumns(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sütunun nereye ekleneceğini belirten dizin. |
num | Integer | Eklenecek sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Columns After(afterPosition, howMany)
Belirtilen sütun konumundan sonra belirli sayıda sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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 |
---|---|---|
after | Integer | Yeni sütunun ekleneceği sütun. |
how | Integer | Eklenecek sütun sayısı. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Columns Before(beforePosition, howMany)
Belirtilen sütun konumundan önce bir dizi sütun ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
before | Integer | Yeni sütunun ekleneceği sütun. |
how | Integer | Eklenecek sütun sayısı. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Image(blobSource, column, row)
Dokümana belirli bir satır ve sütunda resim olarak Blob
ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const binaryData = []; // TODO(developer): Replace with your binary data. const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blob | Blob | Resim içeriğini, 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
Over
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Image(blobSource, column, row, offsetX, offsetY)
Belirli bir satır ve sütuna, piksel kaydırmayla birlikte dokümana resim olarak bir Blob
ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const binaryData = []; // TODO(developer): Replace with your binary data. const blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
blob | Blob | Resim içeriğini, 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öşesine göre yatay ofset (piksel cinsinden). |
offsetY | Integer | Hücre köşesine göre dikey kayma (piksel cinsinden). |
Return
Over
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Image(url, column, row)
Dokümana belirli bir satır ve sütuna resim ekler.
Sağlanan URL'ye herkes erişebilmelidir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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
Over
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Image(url, column, row, offsetX, offsetY)
Dokümana, belirli bir satır ve sütunda piksel kaydırmayla bir resim ekler.
Sağlanan URL'ye herkes erişebilmelidir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const 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öşesine göre yatay ofset (piksel cinsinden). |
offsetY | Integer | Hücre köşesine göre dikey kayma (piksel cinsinden). |
Return
Over
: Eklenen resim.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Row After(afterPosition)
Belirtilen satır konumundan sonra bir satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
after | Integer | Yeni satırın ekleneceği satır. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Row Before(beforePosition)
Belirtilen satır konumundan önce bir satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
before | Integer | Yeni satırın ekleneceği satır. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Rows(rowIndex)
Belirtilen konumda bir sayfaya boş bir satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Shifts all rows down by one sheet.insertRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Satırın nereye ekleneceğini gösteren dizin. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Rows(rowIndex, numRows)
Belirtilen konumdan itibaren bir sayfaya art arda bir veya daha fazla boş satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Shifts all rows down by three sheet.insertRows(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Satırın nereye ekleneceğini gösteren dizin. |
num | Integer | Eklenecek satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Rows After(afterPosition, howMany)
Belirtilen satır konumundan sonra bir dizi satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
after | Integer | Yeni satırların ekleneceği satır. |
how | Integer | Eklenecek satır sayısı. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Rows Before(beforePosition, howMany)
Belirtilen satır konumundan önce bir dizi satır ekler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
before | Integer | Yeni satırların ekleneceği satır. |
how | Integer | Eklenecek satır sayısı. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Slicer(range, anchorRowPos, anchorColPos)
Bu sayfaya yeni bir dilimleyici 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range of the sheet. const range = sheet.getRange('A1:D10'); // Inserts the slicer with a random range into the sheet. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Dilimleyicinin oluşturulduğu aralık. |
anchor | Integer | Dilimleyicinin üst tarafı bu satıra sabitlenir. |
anchor | Integer | Dilimleyicinin üst tarafı bu sütuna sabitlenmiştir. |
Return
Slicer
: Yeni eklenen dilimleyici.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Slicer(range, anchorRowPos, anchorColPos, offsetX, offsetY)
Bu sayfaya yeni bir dilimleyici 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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range. const range = sheet.getRange('A1:D10'); // Inserts a slicer using the random range function. const insertSlicers = sheet.insertSlicer(range.randomize(), 1, 10, 0, 0); // Logs the insert slicer result to the console. console.log(insertSlicers);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Dilimleyicinin oluşturulduğu aralık. |
anchor | Integer | Dilimleyicinin üst tarafı bu satıra sabitlenir. |
anchor | Integer | Dilimleyicinin üst tarafı bu sütuna sabitlenmiştir. |
offsetX | Integer | Hücre köşesine göre yatay ofset (piksel cinsinden). |
offsetY | Integer | Hücre köşesine göre dikey kayma (piksel cinsinden). |
Return
Slicer
: Yeni eklenen dilimleyici.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Column Hidden By User(columnPosition)
Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | İncelenecek sütunun konumu. |
Return
Boolean
: Sütun gizliyse true
, gizli değilse false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Right To Left()
Bu sayfa düzeni sağdan sola ise true
değerini döndürür. E-tabloda varsayılan soldan sağa düzen kullanılıyorsa false
değerini döndürü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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Checks if a spreadsheet is ordered from right to left and logs the result to // the console. console.log(sheet.isRightToLeft());
Return
Boolean
: Sağdan sola ise true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Row Hidden By Filter(rowPosition)
Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | İncelenecek satırın konumu. |
Return
Boolean
: Satır gizliyse true
, aksi takdirde false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Row Hidden By User(rowPosition)
Belirtilen satırın kullanıcı tarafından gizlenip gizlenmediğini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | İncelenecek satırın konumu. |
Return
Boolean
: Satır gizliyse true
, aksi takdirde false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Sheet Hidden()
Sayfa şu anda gizliyse true
değerini döndürür.
const sheet = SpreadsheetApp.getActiveSheet(); if (sheet.isSheetHidden()) { // do something... }
Return
Boolean
: Sayfa gizliyse true
, gizli değilse false
değerini alır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
move Columns(columnSpec, destinationIndex)
Belirtilen aralık tarafından seçilen sütunları destination
ile belirtilen konuma taşır. column
'nin, taşınacak sütunun veya sütun grubunun tamamını tam olarak temsil etmesi gerekmez. column
, aralığın kapsadığı tüm sütunları seçer.
// The code below moves rows A-B to destination index 5. // This results in those columns becoming columns C-D. const sheet = SpreadsheetApp.getActiveSheet(); // Selects column A and column B to be moved. const columnSpec = sheet.getRange('A1:B1'); sheet.moveColumns(columnSpec, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Taşınması gereken sütunları kapsayan bir aralık. |
destination | Integer | Sütunların taşınması gereken dizin. Bu dizinin, sütunlar taşınmadan önceki koordinatlara göre belirlendiğini unutmayın. Mevcut veriler, taşınan sütunlara yer açmak için sağa kaydırılırken kaynak sütunlar grid'den kaldırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizinde bulunabilir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
move Rows(rowSpec, destinationIndex)
Belirtilen aralık tarafından seçilen satırları destination
ile belirtilen konuma taşır. row
'nin, taşınacak bir satırın veya satır grubunun tamamını tam olarak temsil etmesi gerekmez. row
, aralığın kapsadığı tüm satırları seçer.
// The code below moves rows 1-2 to destination index 5. // This results in those rows becoming rows 3-4. const sheet = SpreadsheetApp.getActiveSheet(); // Selects row 1 and row 2 to be moved. const rowSpec = sheet.getRange('A1:A2'); sheet.moveRows(rowSpec, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Taşınması gereken satırları kapsayan bir aralık. |
destination | Integer | Satırların taşınması gereken dizin. Bu dizinin, satırlar taşınmadan önceki koordinatlara dayalı olduğunu unutmayın. Mevcut veriler, taşınan satırlara yer açmak için aşağı kaydırılır. Bu sırada kaynak satırlar ızgaradan kaldırılır. Bu nedenle, veriler başlangıçta belirtilenden farklı bir dizinde bulunabilir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
new Chart()
Bu e-tablo için yeni bir grafik oluşturmak üzere bir oluşturucu döndürür.
Bu örnekte yeni bir grafiğin nasıl oluşturulacağı gösterilmektedir:
const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B8'); const chartBuilder = sheet.newChart(); chartBuilder.addRange(range) .setChartType(Charts.ChartType.LINE) .setPosition(2, 2, 0, 0) .setOption('title', 'My Line Chart!'); sheet.insertChart(chartBuilder.build());
Return
Embedded
: Yeni bir grafik oluşturmak için bir oluşturucu.
protect()
İzin sahibi kullanıcılar dışındaki kullanıcıların sayfayı düzenlemesini engelleyebilecek bir nesne oluşturur. Komut dosyası, sayfanın düzenleyici listesini gerçekten değiştirene kadar (Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
çağrısı yaparak veya Protection.setDomainEdit(editable)
için yeni bir değer ayarlayarak) izinler e-tablonun izinlerini yansıtır. Bu da sayfanın korumasız kalması anlamına gelir. E-tablo zaten korunuyorsa bu yöntem, mevcut koruma ayarlarını temsil eden bir nesne döndürür.
Korumalı bir sayfa, korumasız bölgeler içerebilir.
// Protect the active sheet, then remove all other users from the list of // editors. const sheet = SpreadsheetApp.getActiveSheet(); const protection = sheet.protect().setDescription('Sample protected sheet'); // Ensure the current user is an editor before removing others. Otherwise, if // the user's edit permission comes from a group, the script throws an exception // upon removing the group. const me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Return
Protection
: Koruma ayarlarını temsil eden bir nesne.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove Chart(chart)
Bir grafiği ana sayfadan kaldırır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This removes all the embedded charts from the spreadsheet const charts = sheet.getCharts(); for (const i in charts) { sheet.removeChart(charts[i]); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | Embedded | Kaldırılacak grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Active Range(range)
Belirtilen aralığı etkin sayfada active range
olarak ayarlar. Bu aralığın sol üst hücresi current cell
olur.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); const range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); const selection = sheet.getSelection(); // Current cell: A1 const currentCell = selection.getCurrentCell(); // Active Range: A1:D4 const activeRange = selection.getActiveRange();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin aralık olarak ayarlanacak aralık. |
Return
Range
: Yeni etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Active Range List(rangeList)
Belirtilen aralık listesini etkin sayfada active ranges
olarak ayarlar. Listedeki son aralık active range
olarak ayarlanır.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); const selection = sheet.getSelection(); // Current cell: B2 const currentCell = selection.getCurrentCell(); // Active range: B2:C4 const activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] const activeRangeList = selection.getActiveRangeList();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Seçilecek aralıkların listesi. |
Return
Range
: Yeni seçilen aralık listesi
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Active Selection(range)
Bu sayfa için etkin seçim bölgesini ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D4'); sheet.setActiveSelection(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin seçim olarak ayarlanacak aralık. |
Return
Range
: Yeni etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Active Selection(a1Notation)
Etkin seçimi A1 notasyonunda veya R1C1 notasyonunda belirtildiği şekilde ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.setActiveSelection('A1:D4');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 notasyonunda veya R1C1 notasyonunda belirtildiği şekilde etkin olarak ayarlanacak aralık. |
Return
Range
: Yeni etkin aralık
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Column Group Control Position(position)
Sayfadaki sütun grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setColumnGroupControlPosition( SpreadsheetApp.GroupControlTogglePosition.AFTER, );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
position | Group | Sütun grubu denetimi açma/kapatma düğmesinin konumu. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Column Width(columnPosition, width)
Belirtilen sütunun genişliğini piksel cinsinden ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Ayarlanacak belirli sütunun konumu. |
width | Integer | Ayarlanacak piksel cinsinden genişlik. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Column Widths(startColumn, numColumns, width)
Belirtilen sütunların genişliğini piksel cinsinden ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first three columns to a width of 200 pixels sheet.setColumnWidths(1, 3, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Değiştirilecek başlangıç sütunu konumu. |
num | Integer | Değiştirilecek sütun sayısı. |
width | Integer | Ayarlanacak piksel cinsinden genişlik. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Conditional Format Rules(rules)
Sayfada şu anda mevcut olan tüm koşullu biçimlendirme kurallarını giriş kurallarıyla değiştirir. Kurallar, girilen sırayla değerlendirilir.
// Remove one of the existing conditional format rules. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); rules.splice(1, 1); // Deletes the 2nd format rule. sheet.setConditionalFormatRules(rules);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rules | Conditional | Yeni koşullu biçimlendirme kuralları. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Current Cell(cell)
Belirtilen hücreyi current cell
olarak ayarlar.
Belirtilen hücre zaten seçili bir aralıktaysa bu aralık, hücrenin geçerli hücre olduğu etkin aralık olur.
Belirtilen hücre seçili bir aralıkta yoksa mevcut seçimler kaldırılır ve hücre geçerli hücre ve etkin aralık olur.
Not: Belirtilen Range
tek bir hücreden oluşmalıdır. Aksi takdirde istisna atılır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); const cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); const selection = sheet.getSelection(); // Current cell: B5 const currentCell = selection.getCurrentCell();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
cell | Range | Geçerli hücre olarak ayarlanacak hücre. |
Return
Range
: Yeni ayarlanan geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Frozen Columns(columns)
Belirli sayıda sütunu dondurur. Sıfır ise hiçbir sütun dondurulmaz.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Integer | Dondurulacak sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Frozen Rows(rows)
Belirtilen sayıda satırı dondurur. Sıfır ise hiçbir satır dondurulmaz.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rows | Integer | Dondurulacak satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Hidden Gridlines(hideGridlines)
Sayfa kılavuz çizgilerini gizler veya gösterir.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can us eSpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Hides the gridlines in the sheet. sheet.setHiddenGridlines(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
hide | Boolean | true ise bu sayfadaki kılavuz çizgilerini gizleyin, aksi takdirde kılavuz çizgilerini gösterin. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Name(name)
E-tablo adını belirler.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.setName('not first anymore');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | E-tablonun yeni adı. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Right To Left(rightToLeft)
Sayfa düzenini sağdan sola olarak ayarlar veya ayarı kaldırı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', ); // Gets a sheet by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets the sheet layout, so that the sheet is ordered from right to left. sheet.setRightToLeft(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
right | Boolean | true ise sayfa düzeni sağdan sola olacak şekilde ayarlanır ve A1 hücresi sağ üst köşede olur. false ise sayfa düzeni, sol üstte A1 hücresi olacak şekilde varsayılan soldan sağa ayarlanır. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Row Group Control Position(position)
E-tablodaki satır grubu denetimi açma/kapatma düğmesinin konumunu ayarlar.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlPosition( SpreadsheetApp.GroupControlTogglePosition.AFTER, );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
position | Group | Satır grubu kontrol düğmesinin konumu. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Row Height(rowPosition, height)
Belirtilen satırın piksel cinsinden satır yüksekliğini ayarlar. Varsayılan olarak satırlar, hücre içeriklerine sığacak şekilde büyür. Satırları belirli bir yüksekliğe zorlamak istiyorsanız set
kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Değiştirilecek satır konumu. |
height | Integer | Ayarlanacak piksel cinsinden yükseklik. |
Return
Sheet
: Yöntem zincirleme için yararlı olan sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Row Heights(startRow, numRows, height)
Belirtilen satırların piksel cinsinden yüksekliğini ayarlar. Varsayılan olarak satırlar, hücre içeriklerine sığacak şekilde büyür. Satırları belirli bir yüksekliğe zorlamak istiyorsanız set
değerini kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 20 pixels sheet.setRowHeights(1, 3, 20);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Değiştirilecek başlangıç satırı konumu. |
num | Integer | Değiştirilecek satır sayısı. |
height | Integer | Ayarlanacak piksel cinsinden yükseklik. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Row Heights Forced(startRow, numRows, height)
Belirtilen satırların piksel cinsinden yüksekliğini ayarlar. Varsayılan olarak satırlar, hücre içeriklerine sığacak şekilde büyür. set
kullanıldığında, hücre içerikleri satır yüksekliğinden uzun olsa bile satırlar belirtilen yüksekliğe zorlanacaktır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sets the first three rows to a height of 5 pixels. sheet.setRowHeightsForced(1, 3, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
start | Integer | Değiştirilecek başlangıç satırı konumu. |
num | Integer | Değiştirilecek satır sayısı. |
height | Integer | Ayarlanacak piksel cinsinden yükseklik. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Tab Color(color)
E-tablo sekmesi rengini ayarlar.
// This example assumes there is a sheet named "first" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('first'); first.setTabColor('ff0000'); // Set the color to red. first.setTabColor(null); // Unset the color.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS notasyonunda bir renk kodu ('#ffffff' veya 'white' gibi) veya sekme rengini sıfırlamak için null . |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Tab Color Object(color)
E-tablo sekmesi rengini ayarlar.
// This example assumes there is a sheet named "Sheet1" const ss = SpreadsheetApp.getActiveSpreadsheet(); const first = ss.getSheetByName('Sheet1'); const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); first.setTabColorObject(color); // Set the color to theme accent 1. first.setTabColorObject(null); // Unset the color.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak sayfa sekmesi rengi. |
Return
Sheet
: Zincirleme için bu sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show Columns(columnIndex)
Belirtilen dizindeki sütunu görünür yapar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Unhides the first column sheet.showColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Gizliliği kaldırılacak sütunun dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show Columns(columnIndex, numColumns)
Belirtilen dizinden itibaren bir veya daha fazla sütunu görünür hale getirir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Unhides the first three columns sheet.showColumns(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Gösterilecek sütunların başlangıç dizini. |
num | Integer | Gizliliği kaldırılacak sütunların sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show Rows(rowIndex)
Belirtilen dizindeki satırı görünür hale getirir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Unhides the first row sheet.showRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Gösterilecek satırın dizini. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show Rows(rowIndex, numRows)
Belirtilen dizinden itibaren bir veya daha fazla art arda gelen satırı gösterir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Unhides the first three rows sheet.showRows(1, 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Gizliliği kaldırılacak satırların başlangıç dizini. |
num | Integer | Gizliliğinin kaldırılacağı satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
show Sheet()
E-tabloyu görünür yapar. E-tablo zaten görünür durumdaysa hiçbir etkisi olmaz.
const sheet = SpreadsheetApp.getActiveSheet(); sheet.showSheet();
Return
Sheet
: Geçerli sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition)
Bir sayfayı sütuna göre artan düzende sıralar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sıralama ölçütü olarak kullanılacak sütun. |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(columnPosition, ascending)
Bir sayfayı sütuna göre sıralar. Artan veya azalan düzeni belirtmek için bir parametre alır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sıralama ölçütü olarak kullanılacak sütun. |
ascending | Boolean | Artan sıralama için true , azalan sıralama için false . |
Return
Sheet
: E-tablo. Yöntem zincirleme için kullanışlıdır.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhide Column(column)
Belirtilen aralıktaki sütunu gösterir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden const range = sheet.getRange('A1'); sheet.unhideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizliyse gizliliğini kaldırılacak aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
unhide Row(row)
Belirtilen aralıktaki satırı gösterir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden const range = sheet.getRange('A1'); sheet.unhideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizliyse gizliliğini kaldırılacak aralık. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
update Chart(chart)
Bu sayfadaki grafiği günceller.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This code is going to loop through all the charts and change them to // column charts const charts = sheet.getCharts(); for (const i in charts) { const chart = charts[i]; const newChart = chart.modify().setChartType(Charts.ChartType.COLUMN).build(); sheet.updateChart(newChart); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | Embedded | Güncellenecek grafik. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets