Google E-Tablolar dosyalarına erişebilir ve bu dosyaları değiştirebilir. Yeni e-tablo ekleme ve ortak çalışan ekleme işlemleri sıklıkla yapılır.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
add | Spreadsheet | Belirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya ekler. |
add | Spreadsheet | Belirtilen anahtar ve görünürlükle geliştirici meta verilerini e-tabloya ekler. |
add | Spreadsheet | Belirtilen anahtar ve değere sahip geliştirici meta verilerini e-tabloya ekler. |
add | Spreadsheet | Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini e-tabloya ekler. |
add | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyiciler listesine ekler. |
add | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyiciler listesine ekler. |
add | Spreadsheet | Belirtilen kullanıcı dizisini Spreadsheet için düzenleyiciler listesine ekler. |
add | void | E-Tablo kullanıcı arayüzünde yeni bir menü oluşturur. |
add | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için izleyiciler listesine ekler. |
add | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için izleyiciler listesine ekler. |
add | Spreadsheet | Belirtilen kullanıcı dizisini Spreadsheet için izleyici listesine ekler. |
append | Sheet | Sayfadaki geçerli veri bölgesinin altına bir satır ekler. |
auto | Sheet | Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar. |
copy(name) | Spreadsheet | E-tabloyu kopyalar ve yenisini döndürür. |
create | Developer | Bu e-tablonun 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ştirmek için kullanılabilir. |
delete | Sheet | Şu anda etkin olan sayfayı siler. |
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. |
delete | void | Belirtilen sayfayı siler. |
duplicate | Sheet | Etkin sayfayı kopyalar ve etkin sayfa yapar. |
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 | Sheet | E-tablodaki etkin sayfayı alır. |
get | Blob | Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme. |
get | Banding[] | Bu e-tablodaki tüm bantları döndürür. |
get | Blob | Bu nesnenin içindeki verileri bir blob olarak döndürme. |
get | Integer | Belirtilen sütunun piksel cinsinden genişliğini alır. |
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 | Bu e-tablonun yenileme programlarını alır. |
get | Data | E-tablodaki tüm veri kaynağı e-tablolarını döndürür. |
get | Data | Tüm veri kaynağı tablolarını alır. |
get | Data | E-tablodaki tüm veri kaynaklarını döndürür. |
get | Developer | Üst düzey e-tabloyla ilişkili geliştirici meta verilerini alır. |
get | User[] | Bu Spreadsheet için düzenleyenlerin listesini alır. |
get | String | Yanıtlarını bu e-tabloya gönderen formun URL'sini döndürür veya bu e-tabloyla 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 | String | Bu e-tablonun benzersiz tanımlayıcısını alır. |
get | Over | Sayfadaki tüm ızgara dışı resimleri döndürür. |
get | Number | Yinelenen hesaplama sırasında kullanılan eşik değerini döndürü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 | Yinelemeli hesaplama sırasında kullanılacak maksimum iterasyon sayısını döndürür. |
get | String | Belgenin adını alır. |
get | Named | Bu e-tablodaki tüm adlandırılmış aralıkları alır. |
get | Integer | Bu e-tablodaki sayfa sayısını döndürür. |
get | User | Dokümanın sahibini veya ortak Drive'daki bir doküman için null değerini döndürür. |
get | Spreadsheet | Önceden tanımlanmış temaların listesini döndürür. |
get | Protection[] | Elektronik tablodaki tüm korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi alır. |
get | Range | A1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür. |
get | Range | Adlandırılmış bir aralığı veya belirtilen ada sahip bir aralık bulunamazsa null değerini 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 | Recalculation | Bu e-tablonun hesaplama aralığını 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 | Sheet | Belirtilen ada sahip bir sayfa 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 değer ızgamasını döndürür. |
get | Sheet[] | Bu e-tablodaki tüm sayfaları alır. |
get | String | E-tablo yerel ayarını alır. |
get | Spreadsheet | E-tablonun geçerli temasını veya tema uygulanmamışsa null değerini döndürür. |
get | String | E-tablonun saat dilimini alır. |
get | String | Belirtilen e-tablonun URL'sini döndürür. |
get | User[] | Bu Spreadsheet için görüntüleyenlerin ve yorumcuların listesini alır. |
hide | void | Belirli aralıktaki sütunu veya sütunları gizler. |
hide | void | Belirtilen aralıktaki satırları gizler. |
insert | Sheet | Belirtilen sütun konumundan sonra bir sütun ekler. |
insert | Sheet | Belirtilen sütun konumundan önce bir 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 | Data | E-tabloya yeni bir Data ekler ve veri yürütmeyi başlatır. |
insert | Over | Dokümana belirli bir satır ve sütunda resim olarak Spreadsheet ekler. |
insert | Over | Belirli bir satır ve sütunda, piksel kaydırmayla dokümana resim olarak bir Spreadsheet 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 | Sheet | Belirtilen satır konumundan sonra bir dizi satır ekler. |
insert | Sheet | Belirtilen satır konumundan önce bir dizi satır ekler. |
insert | Sheet | Varsayılan sayfa adı kullanılarak e-tabloya yeni bir sayfa ekler. |
insert | Sheet | E-tabloya belirtilen dizinde yeni bir sayfa ekler. |
insert | Sheet | E-tabloya belirtilen dizinde yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. |
insert | Sheet | Varsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler. |
insert | Sheet | E-tabloya belirtilen ada sahip yeni bir sayfa ekler. |
insert | Sheet | E-tabloya, belirtilen dizinde belirtilen ada sahip yeni bir sayfa ekler. |
insert | Sheet | E-tabloya, belirtilen dizinde belirtilen ada sahip yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. |
insert | Sheet | E-tabloya belirtilen ada sahip yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. |
insert | Sheet | E-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir Data oluşturur ve veri yürütmeyi başlatır. |
is | Boolean | Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür. |
is | Boolean | Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını 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. |
move | void | Etkin sayfayı, sayfalar listesindeki belirtilen konuma taşır. |
move | Sheet | Yeni bir Sheet sayfası oluşturur ve sağlanan grafiği bu sayfaya taşır. |
refresh | void | Geçersiz veri kaynağı nesnelerini atlayarak tüm desteklenen veri kaynaklarını ve bağlı veri kaynağı nesnelerini yeniler. |
remove | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır. |
remove | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için düzenleyenler listesinden kaldırır. |
remove | void | add tarafından eklenen bir menüyü kaldırır. |
remove | void | Belirtilen ada sahip bir adlandırılmış aralığı siler. |
remove | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
remove | Spreadsheet | Belirtilen kullanıcıyı Spreadsheet için görüntüleyen ve yorum yapanlar listesinden kaldırır. |
rename(newName) | void | Dokümanı yeniden adlandırır. |
rename | void | Mevcut etkin sayfayı belirtilen yeni adla yeniden adlandırır. |
reset | Spreadsheet | Uygulanan temayı kaldırır ve e-tabloda varsayılan temayı ayarlar. |
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 | Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. |
set | Sheet | Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. Bu sayfadaki en son seçimi geri yükleme seçeneği de sunulur. |
set | Sheet | Belirtilen sütunun genişliğini piksel cinsinden ayarlar. |
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 | Spreadsheet | Yinelenen hesaplama için minimum eşik değerini belirler. |
set | Spreadsheet | Bu e-tabloda yinelemeli hesaplamanın etkinleştirilip etkinleştirilmeyeceğini belirler. |
set | Spreadsheet | Yinelenen hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama iterasyon sayısını ayarlar. |
set | void | Bir aralığa ad verir. |
set | Spreadsheet | Bu e-tablonun ne sıklıkta yeniden hesaplanacağını belirler. |
set | Sheet | Belirtilen satırın piksel cinsinden satır yüksekliğini ayarlar. |
set | void | E-tablo yerel ayarını belirler. |
set | Spreadsheet | E-tabloda tema ayarlama |
set | void | E-tablonun saat dilimini ayarlar. |
show(userInterface) | void | Kullanıcının tarayıcısının görüntü alanında ortalanan bir iletişim kutusunda özel bir kullanıcı arayüzü bileşeni gösterir. |
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. |
toast(msg) | void | E-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir. |
toast(msg, title) | void | E-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir. |
toast(msg, title, timeoutSeconds) | void | Elektronik tablonun sağ alt köşesinde, belirli bir süre boyunca görünen, belirtilen başlığı ve mesajı içeren bir pop-up pencere gösterir. |
unhide | void | Belirtilen aralıktaki sütunu gösterir. |
unhide | void | Belirtilen aralıktaki satırı gösterir. |
update | void | add tarafından eklenen bir menüyü günceller. |
wait | void | E-tablodaki tüm mevcut yürütme işlemlerinin tamamlanmasını bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar. |
Ayrıntılı dokümanlar
add Developer Metadata(key)
Belirtilen anahtarla geliştirici meta verilerini üst düzey e-tabloya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet. ss.addDeveloperMetadata('NAME') // Gets the first developer metadata object and logs its key. const developerMetaData = ss.getDeveloperMetadata()[0] console.log(developerMetaData.getKey())
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Spreadsheet
: Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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)
Belirtilen anahtar ve görünürlükle geliştirici meta verilerini e-tabloya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' in the developer metadata for the spreadsheet and sets the visibility // to the developer project that created the metadata. ss.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the first developer metadata object and logs its key and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, . Visibility: ${developerMetaData.getVisibility()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Spreadsheet
: Zincirleme için bu 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
add Developer Metadata(key, value)
Belirtilen anahtar ve değere sahip geliştirici meta verilerini e-tabloya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME' and sets the value to 'GOOGLE' in the developer metadata for the // spreadsheet. ss.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the first developer metadata object and logs its key and value. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
Return
Spreadsheet
: Zincirleme için bu 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
add Developer Metadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini e-tabloya ekler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to any developer project with document access. ss.addDeveloperMetadata('NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the first developer metadata object and logs its key, value, and visibility setting. const developerMetaData = ss.getDeveloperMetadata()[0]; console.log(`Key: ${developerMetaData.getKey()}, Value: ${developerMetaData.getValue()}, Visibility: ${developerMetaData.getVisibility()}`);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Spreadsheet
: Zincirleme için bu 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
add Editor(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyiciler listesine ekler. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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 Editor(user)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyiciler listesine ekler. Kullanıcı zaten izleyici listesindeyse bu yöntem, kullanıcıyı izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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 Editors(emailAddresses)
Belirtilen kullanıcı dizisini Spreadsheet
için düzenleyiciler listesine ekler. Kullanıcılardan herhangi biri zaten izleyici listesindeyse bu yöntem, kullanıcıları izleyici listesinden çıkarır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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 Menu(name, subMenus)
E-Tablo kullanıcı arayüzünde yeni bir menü oluşturur.
Her menü girişi, kullanıcı tanımlı bir işlevi çalıştırır. Genellikle, e-tablo yüklendiğinde menünün otomatik olarak oluşturulması için on
işlevinden çağırabilirsiniz.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; // When the user clicks on "addMenuExample" then "Menu Entry 1", the function function1 is // executed. menuEntries.push({name: "Menu Entry 1", functionName: "function1"}); menuEntries.push(null); // line separator menuEntries.push({name: "Menu Entry 2", functionName: "function2"}); ss.addMenu("addMenuExample", menuEntries); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Oluşturulacak menünün adı. |
sub | Object[] | name ve function parametrelerini içeren bir JavaScript eşleme dizisi. Dahil edilen kitaplıklardaki işlevleri (ör.
Library.libFunction1 ) kullanabilirsiniz. |
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 Viewer(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için izleyiciler listesine ekler. Kullanıcı zaten düzenleyiciler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Eklenecek kullanıcının e-posta adresi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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 Viewer(user)
Belirtilen kullanıcıyı Spreadsheet
için izleyiciler listesine ekler. Kullanıcı zaten düzenleyiciler listesindeyse bu yöntemin etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Eklenecek kullanıcının temsili. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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 Viewers(emailAddresses)
Belirtilen kullanıcı dizisini Spreadsheet
için izleyici listesine ekler. Kullanıcılardan herhangi biri zaten düzenleyiciler listesindeyse bu yöntemin bu kullanıcılar üzerinde herhangi bir etkisi olmaz.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String[] | Eklenecek kullanıcıların e-posta adresleri dizisi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Appends a new row with 3 columns to the bottom of the current // data region in the sheet containing the values in the array. sheet.appendRow(["a man", "a plan", "panama"]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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
auto Resize Column(columnPosition)
Belirtilen sütunun genişliğini içeriğine sığacak şekilde ayarlar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange('a1').setValue('Whenever it is a damp, drizzly November in my soul...'); // Sets the first column to a width which fits the text sheet.autoResizeColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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
copy(name)
E-tabloyu kopyalar ve yenisini döndürür.
// This code makes a copy of the current spreadsheet and names it appropriately var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.copy("Copy of " + ss.getName());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Kopyanın adı. |
Return
Spreadsheet
: Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 e-tablonun kapsamında geliştirici meta verilerini bulmak için bir Developer
döndürür. Varsayılan olarak bu işlem, e-tablo, e-tablolar, satırlar ve sütunlarla ilişkili tüm meta verileri dikkate alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds developer metadata to the spreadsheet. ss.addDeveloperMetadata('NAME', 'CHARLIE'); ss.addDeveloperMetadata('COMPANY', 'EXAMPLE ORGANIZATION'); ss.addDeveloperMetadata('TECHNOLOGY', 'JAVASCRIPT'); // Creates a developer metadata finder. const developerMetadataFinder = ss.createDeveloperMetadataFinder(); // Finds the developer metadata objects with 'COMPANY' as the key. const googleMetadataFromSpreadsheet = developerMetadataFinder.withKey('COMPANY').find(); // Gets the first result of developer metadata that has the key 'COMPANY' and logs its value. console.log(googleMetadataFromSpreadsheet[0].getValue());
Return
Developer
: Bu e-tablonun 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ştirmek için kullanılabilir. Arama, e-tablonun ilk sayfasından başlar.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Creates a text finder. var textFinder = spreadsheet.createTextFinder('dog'); // Returns the first occurrence of 'dog' in the spreadsheet. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = findOccurrence.replaceWith('cat');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
find | String | Aranacak metin. |
Return
Text
: E-tablonun Text
değeri.
delete Active Sheet()
Şu anda etkin olan sayfayı siler.
// The code below deletes the currently active sheet and stores the new active sheet in a // variable var newSheet = SpreadsheetApp.getActiveSpreadsheet().deleteActiveSheet();
Return
Sheet
: Yeni etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Column(columnPosition)
Belirtilen sütun konumundaki sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first column sheet.deleteColumn(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Sütunun konumu (ilk sütun 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 Columns(columnPosition, howMany)
Belirtilen sütun konumundan itibaren belirli sayıda sütunu siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at "1" - this deletes the first two columns sheet.deleteColumns(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Integer | Silecek ilk sütunun konumu. |
how | Integer | Sililecek 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
delete Row(rowPosition)
Belirtilen satır konumundaki satırı siler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first row sheet.deleteRow(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at "1" - this deletes the first two rows sheet.deleteRows(1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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
delete Sheet(sheet)
Belirtilen sayfayı siler.
// The code below deletes the specified sheet. var ss = SpreadsheetApp.getActive(); var sheet = ss.getSheetByName('My Sheet'); ss.deleteSheet(sheet);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Silinecek sayfa. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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
duplicate Active Sheet()
Etkin sayfayı kopyalar ve etkin sayfa yapar.
// The code below makes a duplicate of the active sheet SpreadsheetApp.getActiveSpreadsheet().duplicateActiveSheet();
Return
Sheet
: Yeni 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Returns the active cell var cell = sheet.getActiveCell();
Return
Range
: Geçerli etkin hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var 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.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var 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 Active Sheet()
E-tablodaki etkin sayfayı alır.
E-tablodaki etkin sayfa, e-tablo kullanıcı arayüzünde görüntülenen sayfadır.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet();
Return
Sheet
: E-tablodaki etkin sayfa.
get As(contentType)
Bu nesnenin içindeki verileri, belirtilen içerik türüne dönüştürülmüş bir blob olarak döndürme. Bu yöntem, dosya adına uygun uzantıyı ekler (ör. "dosyam.pdf"). Ancak, dosya adının son noktayı (varsa) izleyen kısmının, değiştirilmesi gereken mevcut bir uzantı olduğu varsayılır. Sonuç olarak, "AlışverişListesi.25.12.2014", "AlışverişListesi.25.12.pdf" olur.
Dönüşümler için günlük kotaları görüntülemek istiyorsanız Google Hizmetleri için kotalar başlıklı makaleyi inceleyin. Yeni oluşturulan Google Workspace alanları geçici olarak daha katı kotalara tabi olabilir.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
content | String | Dönüştürülecek MIME türü. Çoğu blob için 'application/pdf' tek geçerli seçenektir. BMP, GIF, JPEG veya PNG biçimindeki resimler için 'image/bmp' , 'image/gif' , 'image/jpeg' veya 'image/png' değerlerinden herhangi biri de geçerlidir. Google Dokümanlar dokümanı için 'text/markdown' de geçerlidir. |
Return
Blob
: Veriler bir blob olarak.
get Bandings()
Bu e-tablodaki tüm bantları döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets an array of the bandings in the spreadsheet. const bandings = ss.getBandings(); // Logs the range of the first banding in the spreadsheet to the console. console.log(bandings[0].getRange().getA1Notation());
Return
Banding[]
: Bu e-tablodaki 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 Blob()
get Column Width(columnPosition)
Belirtilen sütunun piksel cinsinden genişliğini alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.getColumnWidth(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 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.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = sheet.getCurrentCell();
Return
Range
: Geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This represents ALL the data var range = sheet.getDataRange(); var values = range.getValues(); // This logs the spreadsheet in CSV format with a trailing comma for (var i = 0; i < values.length; i++) { var row = ""; for (var j = 0; j < values[i].length; j++) { if (values[i][j]) { row = row + values[i][j]; } row = row + ","; } Logger.log(row); }
Return
Range
: E-tablodaki tüm 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 Refresh Schedules()
Bu e-tablonun yenileme programlarını alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates BigQuery operations for the connected spreadsheet. SpreadsheetApp.enableBigQueryExecution(); // Gets the frequency type of the first referesh schedule in the array. const frequencyType = ss.getDataSourceRefreshSchedules()[0] .getFrequency() .getFrequencyType() .toString(); // Logs the frequency type to the console. console.log(frequencyType);
Return
Data
: Bu e-tablonun yenileme programları.
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 Sheets()
E-tablodaki tüm veri kaynağı e-tablolarını döndürür.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet in the spreadsheet. const dataSource = ss.getDataSourceSheets()[0]; // Gets the name of the data source sheet. console.log(dataSource.asSheet().getName());
Return
Data
: Tüm veri kaynağı e-tablolarını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 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 Data Sources()
E-tablodaki tüm veri kaynaklarını döndürür.
// Turns data execution on for BigQuery data sources. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the data sources on the spreadsheet. const dataSources = ss.getDataSources(); // Logs the name of the first column on the first data source. console.log(dataSources[0].getColumns()[0].getName());
Return
Data
: Tüm veri kaynaklarını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 Developer Metadata()
Üst düzey e-tabloyla ilişkili geliştirici meta verilerini alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds 'Google' as a key to the spreadsheet metadata. ss.addDeveloperMetadata('Google'); // Gets the spreadsheet's metadata. const ssMetadata = ss.getDeveloperMetadata(); // Gets the first set of the spreadsheet's metadata and logs the key to the console. console.log(ssMetadata[0].getKey());
Return
Developer
: Bu aralıkla 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 Editors()
Bu Spreadsheet
için düzenleyenlerin listesini alır.
Return
User[]
: Düzenleme iznine sahip kullanıcı 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 Form Url()
Yanıtlarını bu e-tabloya gönderen formun URL'sini döndürür veya bu e-tabloyla ilişkili bir form yoksa null
değerini döndürür. Birden fazla form bu e-tabloya yanıt gönderirse döndürülen form URL'si belirsizdir. Alternatif olarak, sayfa başına form URL'si ilişkilendirmeleri Sheet.getFormUrl()
yöntemi aracılığıyla da alınabilir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the form URL from the spreadsheet. const formUrl = ss.getFormUrl(); // Logs the form URL to the console. console.log(formUrl);
Return
String
: Yanıtlarını bu e-tabloya yerleştiren formun URL'si veya bu e-tabloyla 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen columns: %s", sheet.getFrozenColumns());
Return
Integer
: Dondurulmuş 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
get Frozen Rows()
Dondurulmuş satır sayısını döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log("Number of frozen rows: %s", sheet.getFrozenRows());
Return
Integer
: Dondurulmuş satı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 Id()
Bu e-tablonun benzersiz tanımlayıcısını alır. E-tablo kimliği, URL'sinden ayıklanabilir. Örneğin, https://docs.google.com/spreadsheets/d/abc1234567/edit#gid=0 URL'sindeki e-tablo kimliği "abc1234567" olur.
// The code below logs the ID for the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getId());
Return
String
: E-tablonun benzersiz kimliği (veya anahtarı).
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 Iterative Calculation Convergence Threshold()
Yinelenen hesaplama sırasında kullanılan eşik değerini döndürür. Art arda yapılan hesaplamaların sonuçları bu değerden daha az farklı olduğunda iteratif hesaplama durur.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Return
Number
: Yakınsama eşiğ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 Last Column()
İçeriği olan son sütunun konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: 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()
İçerik içeren son satırın konumunu döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This logs the value in the very last cell of this sheet var lastRow = sheet.getLastRow(); var lastColumn = sheet.getLastColumn(); var lastCell = sheet.getRange(lastRow, lastColumn); Logger.log(lastCell.getValue());
Return
Integer
: 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 Iterative Calculation Cycles()
Yinelemeli hesaplama sırasında kullanılacak maksimum iterasyon sayısını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Return
Integer
: Maksimum hesaplama iterasyonu 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 Name()
Belgenin adını alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getName());
Return
String
: E-tablonun adı.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 e-tablodaki tüm adlandırılmış aralıkları alır.
// The code below logs the name of the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { Logger.log(namedRanges[i].getName()); }
Return
Named
: E-tablodaki tüm adlandırılmış aralıklardan oluşan bir dizi.
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 Num Sheets()
Bu e-tablodaki sayfa sayısını döndürür.
// The code below logs the number of sheets in the active spreadsheet. Logger.log(SpreadsheetApp.getActiveSpreadsheet().getNumSheets());
Return
Integer
: E-tablodaki sayfa sayısı.
get Owner()
Dokümanın sahibini veya ortak Drive'daki bir doküman için null
değerini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var owner = ss.getOwner(); Logger.log(owner.getEmail());
Return
User
: Dokümanın sahibi veya doküman ortak Drive'daysa null
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Predefined Spreadsheet Themes()
Önceden tanımlanmış temaların listesini döndürür.
// The code below returns the list of predefined themes. var predefinedThemesList = SpreadsheetApp.getActiveSpreadsheet() .getPredefinedSpreadsheetThemes();
Return
Spreadsheet
: Önceden tanımlanmış temaları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 Protections(type)
Elektronik tablodaki tüm korumalı aralıkları veya sayfaları temsil eden bir nesne dizisi alır.
// Remove all range protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.RANGE); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
// Remove all sheet protections in the spreadsheet that the user has permission to edit. var ss = SpreadsheetApp.getActive(); var protections = ss.getProtections(SpreadsheetApp.ProtectionType.SHEET); for (var i = 0; i < protections.length; i++) { var protection = protections[i]; if (protection.canEdit()) { protection.remove(); } }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
type | Protection | Korunan alanın türü (Spreadsheet veya Spreadsheet ). |
Return
Protection[]
: Elektronik tablodaki tüm korumalı aralıkları veya sayfaları temsil eden bir nesne 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(a1Notation)
A1 notasyonunda veya R1C1 notasyonunda belirtilen aralığı döndürür.
// Get a range A1:D4 on sheet titled "Invoices" var ss = SpreadsheetApp.getActiveSpreadsheet(); var range = ss.getRange("Invoices!A1:D4"); // Get cell A1 on the first sheet var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
a1Notation | String | A1 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 By Name(name)
Adlandırılmış bir aralığı veya belirtilen ada sahip bir aralık bulunamazsa null
değerini döndürür. E-tablonun birden fazla sayfasında aynı aralık adı kullanılıyorsa sayfa adını ek tırnak işaretleri olmadan belirtin (ör. get
veya get
, get
değil).
// Log the number of columns for the range named 'TaxRates' in the active spreadsheet. var range = SpreadsheetApp.getActiveSpreadsheet().getRangeByName('TaxRates'); if (range != null) { Logger.log(range.getNumColumns()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Alınacak aralığın adı. |
Return
Range
: Belirtilen ada sahip hücre aralığı.
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. var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var 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 Recalculation Interval()
Bu e-tablonun hesaplama aralığını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Logs the calculation interval for the spreadsheet to the console. console.log(ss.getRecalculationInterval().toString());
Return
Recalculation
: Bu e-tablonun hesaplama 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
get Row Height(rowPosition)
Belirtilen satırın piksel cinsinden yüksekliğini alır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.getRowHeight(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var currentCell = selection.getCurrentCell();
Return
Selection
: Geçerli seçim
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Sheet By Name(name)
Belirtilen ada sahip bir sayfa döndürür.
Birden fazla sayfa aynı ada sahipse en soldaki sayfa döndürülür. Belirtilen ada sahip bir sayfa yoksa null
döndürülür.
// The code below logs the index of a sheet named "Expenses" var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheetByName("Expenses"); if (sheet != null) { Logger.log(sheet.getIndex()); }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Alınacak e-tablonun adı. |
Return
Sheet
: Belirtilen ada sahip sayfa.
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetId());
Return
Integer
: E-tabloya özgü sayfa kimliği
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; Logger.log(sheet.getSheetName());
Return
String
: Sayfanın adı
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 bir değer ızgarası 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The two samples below produce the same output var values = sheet.getSheetValues(1, 1, 3, 3); Logger.log(values); var range = sheet.getRange(1, 1, 3, 3); values = range.getValues(); Logger.log(values);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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ütunların 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 Sheets()
Bu e-tablodaki tüm sayfaları alır.
// The code below logs the name of the second sheet var sheets = SpreadsheetApp.getActiveSpreadsheet().getSheets(); if (sheets.length > 1) { Logger.log(sheets[1].getName()); }
Return
Sheet[]
: E-tablodaki tüm sayfaların dizisi.
get Spreadsheet Locale()
E-tablo yerel ayarını alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Return
String
: E-tablo yerel ayarı.
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 Spreadsheet Theme()
E-tablonun geçerli temasını veya tema uygulanmamışsa null
değerini döndürür.
// The code below returns the current theme of the spreadsheet. var currentTheme = SpreadsheetApp.getActiveSpreadsheet().getSpreadsheetTheme();
Return
Spreadsheet
: Geçerli uygulanan tema.
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 Spreadsheet Time Zone()
E-tablonun saat dilimini alır.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Return
String
: "Uzun" biçimde belirtilen saat dilimi (ör. Joda.org tarafından listelenen "America/New_York").
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 Url()
Belirtilen e-tablonun URL'sini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); Logger.log(ss.getUrl());
Return
String
: Belirtilen e-tablonun URL'si.
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 Viewers()
Bu Spreadsheet
için görüntüleyenlerin ve yorumcuların listesini alır.
Return
User[]
: Görüntüleme veya yorum yapma iznine sahip kullanıcı 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
hide Column(column)
Belirli aralıktaki sütunu veya sütunları gizler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // This hides the first column let range = sheet.getRange("A1"); sheet.hideColumn(range); // This hides the first 3 columns let range = sheet.getRange("A:C"); sheet.hideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | Gizlenecek sütun aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This hides the first row var range = sheet.getRange("A1"); sheet.hideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | Gizlenecek satır aralığı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column after the first column position sheet.insertColumnAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a column in the first column position sheet.insertColumnBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 After(afterPosition, howMany)
Belirtilen sütun konumundan sonra belirli sayıda sütun ekler.
let ss = SpreadsheetApp.getActiveSpreadsheet(); let sheet = ss.getSheets()[0]; // Inserts two columns after the first column on the first sheet of the spreadsheet. sheet.insertColumnsAfter(1,2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five columns before the first column sheet.insertColumnsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 Data Source Sheet(spec)
E-tabloya yeni bir Data
ekler ve veri yürütmeyi başlatır. Bu işlem, yan etki olarak yeni e-tabloyu etkin e-tablo yapar.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Builds a data source specification. // TODO (developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setTableProjectId('bigquery-public-data') .setDatasetId('ncaa_basketball') .setTableId('mbb_historical_teams_games') .build(); // Adds the data source and its data to the spreadsheet. ss.insertDataSourceSheet(dataSourceSpec);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | Data | Eklenecek veri kaynağı spesifikasyonu. |
Return
Data
: Yeni 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
insert Image(blobSource, column, row)
Dokümana belirli bir satır ve sütunda resim olarak Spreadsheet
ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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ırması uygulanmış bir Spreadsheet
resmi ekler. Resim boyutu, blob içeriklerinden alınır. Desteklenen maksimum blob boyutu 2 MB'tır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var blob = Utilities.newBlob(binaryData, 'image/png', 'MyImageName'); sheet.insertImage(blob, 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | Resmin URL'si. |
column | Integer | Izgara sütunu konumu. |
row | Integer | Izgara satır konumu. |
Return
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.insertImage("https://www.google.com/images/srpr/logo3w.png", 1, 1, 10, 10);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
url | String | Resmin URL'si. |
column | Integer | Sütun konumu. |
row | Integer | Satır konumu. |
offsetX | Integer | Hücre köş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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row after the first row position sheet.insertRowAfter(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts a row before the first row position sheet.insertRowBefore(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 After(afterPosition, howMany)
Belirtilen satır konumundan sonra bir dizi satır ekler.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows after the first row sheet.insertRowsAfter(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This inserts five rows before the first row sheet.insertRowsBefore(1, 5);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 Sheet()
Varsayılan sayfa adı kullanılarak e-tabloya yeni bir sayfa ekler. Yeni e-tablo etkin e-tablo olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet();
Return
Sheet
: Yeni 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 Sheet(sheetIndex)
E-tabloya belirtilen dizinde yeni bir sayfa ekler. Yeni e-tablo etkin e-tablo olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablonun ilk sayfası olarak eklemek için bu değeri 0 olarak ayarlayın. |
Return
Sheet
: Yeni 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 Sheet(sheetIndex, options)
E-tabloya belirtilen dizinde yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. Yeni eklenen sayfa etkin sayfa olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet(1, {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablonun ilk sayfası olarak eklemek için bu değeri 0 olarak ayarlayın. |
options | Object | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesinde bulunan tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Sheet(options)
Varsayılan sayfa adı ve isteğe bağlı gelişmiş bağımsız değişkenler kullanarak e-tabloya yeni bir sayfa ekler. Yeni eklenen sayfa etkin sayfa olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet({template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen isteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesinde bulunan tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, bu E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Sheet(sheetName)
E-tabloya belirtilen ada sahip yeni bir sayfa ekler. Yeni e-tablo etkin e-tablo olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | String | Yeni sayfanın adı. |
Return
Sheet
: Yeni 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 Sheet(sheetName, sheetIndex)
E-tabloya, belirtilen dizinde belirtilen ada sahip yeni bir sayfa ekler. Yeni sayfa etkin sayfa olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.insertSheet('My New Sheet', 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | String | Yeni sayfanın adı. |
sheet | Integer | Yeni oluşturulan sayfanın dizini. Bir sayfayı e-tablonun ilk sayfası olarak eklemek için bu değeri 0 olarak ayarlayın. |
Return
Sheet
: Yeni 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 Sheet(sheetName, sheetIndex, options)
E-tabloya, belirtilen dizinde belirtilen ada sahip yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. Yeni eklenen sayfa etkin sayfa olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', 1, {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | String | Yeni sayfanın adı. |
sheet | Integer | Yeni eklenen sayfanın dizini. Bir e-tabloya ilk sayfa olarak eklemek için bu değeri 0 olarak ayarlayın. |
options | Object | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesinde bulunan tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Sheet(sheetName, options)
E-tabloya belirtilen ada sahip yeni bir sayfa ekler ve isteğe bağlı gelişmiş bağımsız değişkenleri kullanır. Yeni eklenen sayfa etkin sayfa olur.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var templateSheet = ss.getSheetByName('Sales'); ss.insertSheet('My New Sheet', {template: templateSheet});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | String | Yeni sayfanın adı. |
options | Object | İsteğe bağlı JavaScript gelişmiş bağımsız değişkenleri. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
template | Sheet | Şablon sayfası nesnesinde bulunan tüm veriler yeni sayfaya kopyalanır. Sayfa şablonu, E-tablo nesnesinin sayfalarından biri olmalıdır. |
Return
Sheet
: Yeni sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Sheet With Data Source Table(spec)
E-tabloya yeni bir sayfa ekler, belirtilen veri kaynağı spesifikasyonuyla sayfanın tamamını kapsayan bir Data
oluşturur ve veri yürütmeyi başlatır. Bu işlem, yeni e-tabloyu etkin e-tablo yapar.
Veri kaynağı türü etkinleştirilmemişse istisna atar. Belirli bir veri kaynağı türü için veri yürütme işlemini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Adds a sheet and sets cell A1 as the parameter cell. const parameterCell = ss.insertSheet('parameterSheet').getRange('A1'); // Sets the value of the parameter cell to 'Duke'. parameterCell.setValue('Duke'); const query = 'select * from `bigquery-public-data`.`ncaa_basketball`.' + '`mbb_historical_tournament_games` WHERE win_school_ncaa = @SCHOOL'; // Adds a data source with a query parameter. // TODO(developer): Update the project ID to your own Google Cloud project ID. const dataSourceSpec = SpreadsheetApp.newDataSourceSpec() .asBigQuery() .setProjectId('project-id-1') .setRawQuery(query) .setParameterFromCell('SCHOOL', 'parameterSheet!A1') .build(); // Adds sheets for the data source and data source table to the spreadsheet. ss.insertSheetWithDataSourceTable(dataSourceSpec);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
spec | Data | Eklenecek veri kaynağı spesifikasyonu. |
Return
Sheet
: Yeni 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
is Column Hidden By User(columnPosition)
Belirtilen sütunun kullanıcı tarafından gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Columns start at 1 Logger.log(sheet.isColumnHiddenByUser(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 Iterative Calculation Enabled()
Bu e-tabloda yinelemeli hesaplamanın etkin olup olmadığını döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Return
Boolean
: yinelemeli hesaplama etkinse true
, aksi takdirde false
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 Filter(rowPosition)
Belirtilen satırın bir filtre tarafından (filtre görünümü değil) gizlenip gizlenmediğini döndürür.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Rows start at 1 Logger.log(sheet.isRowHiddenByFilter(1));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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
move Active Sheet(pos)
Etkin sayfayı, sayfalar listesindeki belirtilen konuma taşır. Konum negatifse veya sayfa sayısından büyükse istisna oluşturur.
// This example assumes that there are 2 sheets in the current // active spreadsheet: one named "first" in position 1 and another named "second" // in position 2. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // Gets the "first" sheet and activates it. var sheet = spreadsheet.getSheetByName("first").activate(); // Logs 'Current index of sheet: 1' console.log("Current index of sheet: %s", sheet.getIndex()); spreadsheet.moveActiveSheet(2); // Logs 'New index of sheet: 2' console.log("New index of sheet: %s", sheet.getIndex());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
pos | Integer | Etkin sayfayı sayfalar listesinde taşıyacağınız 1 tabanlı dizin 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
move Chart To Object Sheet(chart)
Yeni bir Sheet
sayfası oluşturur ve sağlanan grafiği bu sayfaya taşır. Grafik zaten kendi sayfasındaysa yeni bir sayfa oluşturulmadan bu sayfa döndürülür.
var sheet = SpreadsheetApp.getActiveSheet(); var chart = sheet.newChart().setPosition(1, 1, 0, 0).build(); sheet.insertChart(chart); var objectSheet = SpreadsheetApp.getActive().moveChartToObjectSheet(chart);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
chart | Embedded | Taşınacak grafik. |
Return
Sheet
: Grafiğin bulunduğu 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
refresh All Data Sources()
Geçersiz veri kaynağı nesnelerini atlayarak tüm desteklenen veri kaynaklarını ve bağlı veri kaynağı nesnelerini yeniler.
Belirli bir veri kaynağı türü için veri yürütme işlemlerini etkinleştirmek üzere Spreadsheet
yöntemlerini kullanın.
// Activates BigQuery operations. SpreadsheetApp.enableBigQueryExecution(); // Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets the first data source sheet on the spreadsheet. const dataSheet = ss.getDataSourceSheets()[0]; // Refreshes all data sources on the spreadsheet. ss.refreshAllDataSources(); // Logs the last refreshed time of the first data source sheet. console.log(`Last refresh time: ${dataSheet.getStatus().getLastRefreshedTime()}`);
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Editor(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyenler listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olan kullanıcıların Spreadsheet
'e erişimini engellemez. Örneğin, Spreadsheet
kullanıcının alanının tamamıyla paylaşılıyorsa veya Spreadsheet
, kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyen kullanıcılar listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Editor(user)
Belirtilen kullanıcıyı Spreadsheet
için düzenleyenler listesinden kaldırır. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait olan kullanıcıların Spreadsheet
'e erişimini engellemez. Örneğin, Spreadsheet
kullanıcının alanının tamamıyla paylaşılıyorsa veya Spreadsheet
, kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı görüntüleyen kullanıcılar listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Menu(name)
add
tarafından eklenen bir menüyü kaldırır. name
bağımsız değişkeni, add
çağrısıyla aynı değere sahip olmalıdır.
// The onOpen function is executed automatically every time a Spreadsheet is loaded function onOpen() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.addMenu("badMenu", [{name: "remove bad menu", functionName: "removeBadMenu"}, {name: "foo", functionName: "foo"}]); } function removeBadMenu() { var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.removeMenu("badMenu"); // name must match the name used when added the menu } function foo(){ // Do nothing }
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Kaldırılacak menünün adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Named Range(name)
Belirtilen ada sahip bir adlandırılmış aralığı siler. E-tabloda belirtilen ada sahip bir aralık bulunamazsa istisna atar.
// The code below creates a new named range "foo", and then remove it. var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("foo", ss.getActiveRange()); ss.removeNamedRange("foo");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Aralık adı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Viewer(emailAddress)
Belirtilen kullanıcıyı Spreadsheet
için görüntüleyen ve yorum yapanlar listesinden kaldırır. Kullanıcı izleyici veya yorumcu değilse bu yöntemin hiçbir etkisi yoktur. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların Spreadsheet
'e erişmesini de engellemez. Örneğin, Spreadsheet
kullanıcının alanının tamamıyla paylaşılıyorsa veya Spreadsheet
kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyiciler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
email | String | Kaldırılacak kullanıcının e-posta adresi. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Viewer(user)
Belirtilen kullanıcıyı Spreadsheet
için görüntüleyen ve yorum yapanlar listesinden kaldırır. Kullanıcı izleyici değil de düzenleyiciyse bu yöntemin hiçbir etkisi olmaz. Bu yöntem, genel erişime sahip bir kullanıcı sınıfına ait kullanıcıların Spreadsheet
'e erişimini de engellemez. Örneğin, Spreadsheet
kullanıcının alanının tamamıyla paylaşılıyorsa veya Spreadsheet
kullanıcının erişebildiği bir ortak Drive'da bulunuyorsa.
Drive dosyaları için bu işlem, kullanıcıyı düzenleyiciler listesinden de kaldırır.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | User | Kaldırılacak kullanıcının temsili. |
Return
Spreadsheet
: Zincirleme için bu Spreadsheet
.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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
rename(newName)
Dokümanı yeniden adlandırır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.rename("This is the new name");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
new | String | Belgenin yeni 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
rename Active Sheet(newName)
Mevcut etkin sayfayı belirtilen yeni adla yeniden adlandırır.
// The code below renames the active sheet to "Hello world" SpreadsheetApp.getActiveSpreadsheet().renameActiveSheet("Hello world");
Parametreler
Ad | Tür | Açıklama |
---|---|---|
new | String | Mevcut etkin sayfanın yeni 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
reset Spreadsheet Theme()
Uygulanan temayı kaldırır ve e-tabloda varsayılan temayı ayarlar.
// The code below applies default theme on the spreadsheet. SpreadsheetApp.getActiveSpreadsheet().resetSpreadsheetTheme();
Return
Spreadsheet
: Varsayılan tema.
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.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var range = sheet.getRange('A1:D4'); sheet.setActiveRange(range); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D4 var activeRange = selection.getActiveRange();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin aralık olarak ayarlanacak aralık. |
Return
Range
: Yeni 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.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); sheet.setActiveRangeList(rangeList); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D4"); sheet.setActiveSelection(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
range | Range | Etkin seçim olarak ayarlanacak aralık. |
Return
Range
: Yeni 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var 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 Active Sheet(sheet)
Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. Google E-Tablolar kullanıcı arayüzünde, farklı bir e-tabloya ait olmadığı sürece seçilen e-tablo gösterilir.
// The code below makes the first sheet active in the active spreadsheet. var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); spreadsheet.setActiveSheet(spreadsheet.getSheets()[0]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Etkin sayfa olarak ayarlanacak sayfa. |
Return
Sheet
: Etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Sheet(sheet, restoreSelection)
Belirtilen sayfayı e-tablodaki etkin sayfa olarak ayarlar. Bu sayfadaki en son seçimi geri yükleme seçeneği de sunulur. Google E-Tablolar kullanıcı arayüzünde, farklı bir e-tabloya ait olmadığı sürece seçilen sayfa gösterilir.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var firstSheet = spreadsheet.getSheets()[0]; var secondSheet = spreadsheet.getSheets()[1]; // Set the first sheet as the active sheet and select the range D4:F4. spreadsheet.setActiveSheet(firstSheet).getRange('D4:F4').activate(); // Switch to the second sheet to do some work. spreadsheet.setActiveSheet(secondSheet); // Switch back to first sheet, and restore its selection. spreadsheet.setActiveSheet(firstSheet, true); // The selection of first sheet is restored, and it logs D4:F4 var range = spreadsheet.getActiveSheet().getSelection().getActiveRange(); Logger.log(range.getA1Notation());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Yeni etkin sayfa. |
restore | Boolean | Tf true ise yeni etkin sayfa etkin hale geldiğinde yeni sayfanın en son seçimi tekrar seçilir; false ise yeni sayfa, mevcut seçim değiştirilmeden etkin hale gelir. |
Return
Sheet
: Yeni etkin sayfa.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first column to a width of 200 pixels sheet.setColumnWidth(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 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.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getActiveSheet(); var cell = sheet.getRange('B5'); sheet.setCurrentCell(cell); var selection = sheet.getSelection(); // Current cell: B5 var currentCell = selection.getCurrentCell();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
cell | Range | Geçerli hücre olarak ayarlanacak hücre. |
Return
Range
: Yeni ayarlanan geçerli hücre
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first column sheet.setFrozenColumns(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Integer | Dondurulacak sütun sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Freezes the first row sheet.setFrozenRows(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rows | Integer | Dondurulacak satır sayısı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Iterative Calculation Convergence Threshold(minThreshold)
Yinelenen hesaplama için minimum eşik değerini belirler. Art arda yapılan hesaplamaların sonuçları bu değerden daha az farklı olduğunda iteratif hesaplama durur. Bu değer negatif olmamalıdır ve varsayılan olarak 0, 05'tir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the iterative calculation convergence threshold for the spreadsheet. ss.setIterativeCalculationConvergenceThreshold(2); // Logs the threshold to the console. console.log(ss.getIterativeCalculationConvergenceThreshold());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
min | Number | Minimum yakınsama eşiği (negatif olmayan bir değer olmalıdır). |
Return
Spreadsheet
: Zincirleme için bu 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
set Iterative Calculation Enabled(isEnabled)
Bu e-tabloda yinelemeli hesaplamanın etkinleştirilip etkinleştirilmeyeceğini belirler. Maksimum hesaplama döngüsü sayısı ve yakınsama eşiği, hesaplama etkinleştirildiğinde daha önce ayarlanmamışsa varsayılan olarak sırasıyla 50 ve 0,05 olur. Bu iki ayar daha önce ayarlandıysa önceki değerlerini korur.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Activates iterative calculation on the spreadsheet. ss.setIterativeCalculationEnabled(true); // Logs whether iterative calculation is activated for the spreadsheet. console.log(ss.isIterativeCalculationEnabled());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Boolean | true yinelemeli hesaplama etkinleştirilecekse; false
aksi takdirde. |
Return
Spreadsheet
: Zincirleme için bu 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
set Max Iterative Calculation Cycles(maxIterations)
Yinelenen hesaplama sırasında gerçekleştirilmesi gereken maksimum hesaplama iterasyon sayısını ayarlar. Bu değer 1 ile 10.000 arasında (dahil) olmalıdır ve varsayılan olarak 50'dir.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the max iterative calculation cycles for the spreadsheet. ss.setMaxIterativeCalculationCycles(10); // Logs the max iterative calculation cycles to the console. console.log(ss.getMaxIterativeCalculationCycles());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
max | Integer | Maksimum hesaplama yineleme sayısı (1 ile 10.000 arasında). |
Return
Spreadsheet
: Zincirleme için bu e-tablo.
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Named Range(name, range)
Bir aralığa ad verir.
// The code below creates a new named range "TaxRates" in the active spreadsheet var ss = SpreadsheetApp.getActiveSpreadsheet(); ss.setNamedRange("TaxRates", SpreadsheetApp.getActiveRange());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Aralığa verilecek ad. |
range | Range | Aralık spesifikasyonu. |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Recalculation Interval(recalculationInterval)
Bu e-tablonun ne sıklıkta yeniden hesaplanacağını belirler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the calculation interval for the spreadsheet to 'ON_CHANGE'. const interval = ss.setRecalculationInterval(SpreadsheetApp.RecalculationInterval.ON_CHANGE); // Logs the calculation interval to the console. console.log(interval);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
recalculation | Recalculation | Yeni yeniden hesaplama aralığı. |
Return
Spreadsheet
: Zincirleme için bu 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
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 Sheet.setRowHeightsForced(startRow, numRows, height)
kullanın.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sets the first row to a height of 200 pixels sheet.setRowHeight(1, 200);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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 Spreadsheet Locale(locale)
E-tablo yerel ayarını belirler.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the spreadsheet locale. ss.setSpreadsheetLocale('fr'); // Gets the spreadsheet locale. const ssLocale = ss.getSpreadsheetLocale(); // Logs the locale to the console. console.log(ssLocale);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
locale | String | Kullanılacak yerel ayar kodu (ör. "en", "fr" veya "en_US"). |
Yetkilendirme
Bu yöntemi kullanan komut dosyaları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 Spreadsheet Theme(theme)
E-tabloda tema ayarlama
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); // The code below sets the second predefined theme as the current theme of the spreadsheet. var predefinedThemesList = spreadsheet.getPredefinedSpreadsheetThemes(); spreadsheet.setSpreadsheetTheme(predefinedThemesList[1]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
theme | Spreadsheet | Uygulanacak tema. |
Return
Spreadsheet
: Yeni mevcut tema.
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 Spreadsheet Time Zone(timezone)
E-tablonun saat dilimini ayarlar.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Sets the time zone of the spreadsheet. ss.setSpreadsheetTimeZone('America/New_York'); // Gets the time zone of the spreadsheet. const ssTimeZone = ss.getSpreadsheetTimeZone(); // Logs the time zone to the console. console.log(ssTimeZone);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timezone | String | "Uzun" biçimde belirtilen saat dilimi (ör. Joda.org tarafından listelenen "America/New_York"). |
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(userInterface)
Kullanıcının tarayıcısının görüntü alanında ortalanan bir iletişim kutusunda özel bir kullanıcı arayüzü bileşeni gösterir. Sunucu tarafı komut dosyasının yürütmesi askıya alınmaz. Kullanıcı arayüzü bileşeninin sunucu tarafı ile iletişim kurabilmesi için sunucu tarafı komut dosyasına asenkron geri çağırma yapması gerekir.
Sunucu tarafı komut dosyası daha önce henüz kapatılmamış bir iletişim kutusu gösterdiyse mevcut iletişim kutusu, yeni istenen iletişim kutusunun kullanıcı arayüzüyle değiştirilir.
Aşağıdaki kod snippet'inde, belirtilen başlık, yükseklik ve genişliğe sahip bir iletişim kutusunda basit bir Html
uygulaması gösterilmektedir:
var htmlApp = HtmlService .createHtmlOutput('<p>A change of speed, a change of style...</p>') .setTitle('My HtmlService Application') .setWidth(250) .setHeight(300); SpreadsheetApp.getActiveSpreadsheet().show(htmlApp); // The script resumes execution immediately after showing the dialog.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
user | Object | Html |
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/script.container.ui
sort(columnPosition)
Bir sayfayı sütuna göre artan düzende sıralar.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, ascending sheet.sort(1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Sorts the sheet by the first column, descending sheet.sort(1, false);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
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
toast(msg)
E-tablonun sağ alt köşesinde, belirtilen mesajı içeren bir pop-up pencere gösterir.
// Show a popup with the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Ekranda gösterilecek mesaj. |
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
toast(msg, title)
E-tablonun sağ alt köşesinde, belirtilen mesajı ve başlığı içeren bir pop-up pencere gösterir.
// Show a popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Ekranda gösterilecek mesaj. |
title | String | İsteğe bağlı olarak gösterilecek pop-up mesajın başlığı. |
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
toast(msg, title, timeoutSeconds)
Elektronik tablonun sağ alt köşesinde, belirli bir süre boyunca görünen, belirtilen başlığı ve mesajı içeren bir pop-up pencere gösterir.
// Show a 3-second popup with the title "Status" and the message "Task started". SpreadsheetApp.getActiveSpreadsheet().toast('Task started', 'Status', 3);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
msg | String | Ekranda gösterilecek mesaj. |
title | String | İsteğe bağlı olarak gösterilecek pop-up mesajın başlığı. |
timeout | Number | Zaman aşımı (saniye cinsinden); null ise varsayılan olarak 5 saniyedir; negatif ise kaldırılana kadar gösterilir. |
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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first column if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideColumn(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
column | Range | 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.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This unhides the first row if it was previously hidden var range = sheet.getRange("A1"); sheet.unhideRow(range);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Range | 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 Menu(name, subMenus)
add
tarafından eklenen bir menüyü günceller. add
ile aynı şekilde çalışır.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var menuEntries = []; menuEntries.push({name: "Lone Menu Entry", functionName: "function1"}); ss.updateMenu("addMenuExample", menuEntries);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
name | String | Güncellenecek menünün adı. |
sub | Object[] | name ve function parametrelerini içeren bir JavaScript eşleme dizisi. Dahil edilen kitaplıklardaki işlevleri (ör.
Library.libFunction1 ) kullanabilirsiniz. |
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
wait For All Data Executions Completion(timeoutInSeconds)
E-tablodaki tüm mevcut yürütme işlemlerinin tamamlanmasını bekler ve belirtilen saniye sayısından sonra zaman aşımına uğrar. Zaman aşımı olduğunda yürütmeler tamamlanmazsa istisna atar ancak veri yürütme işlemlerini iptal etmez.
Parametreler
Ad | Tür | Açıklama |
---|---|---|
timeout | Integer | Saniye cinsinden veri yürütme işleminin tamamlanmasını bekleme süresi. Maksimum süre 300 saniyedir. |
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