E-tablo aralıklarını erişip değiştirme. Aralık, bir sayfadaki tek bir hücre veya bir sayfadaki bitişik hücreler grubu olabilir.
Yöntemler
Yöntem | Dönüş türü | Kısa açıklama |
---|---|---|
activate() | Range | Belirtilen aralığı active range olarak, aralığın sol üst hücresini ise current cell olarak ayarlar. |
activate | Range | Belirtilen hücreyi current cell olarak ayarlar. |
add | Range | Belirtilen anahtarla geliştirici meta verilerini aralığa ekler. |
add | Range | Belirtilen anahtar ve görünürlükle geliştirici meta verilerini aralığa ekler. |
add | Range | Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler. |
add | Range | Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini alana ekler. |
apply | Banding | Aralıka varsayılan bir sütun bantları teması uygular. |
apply | Banding | Belirtilen bir sütun bantlama temasını aralığa uygular. |
apply | Banding | Belirtilen sütun bantlama temasını, belirtilen başlık ve altbilgi ayarlarıyla aralığa uygular. |
apply | Banding | Aralıka varsayılan bir satır gruplandırma teması uygular. |
apply | Banding | Belirtilen satır gruplandırma temasını aralığa uygular. |
apply | Banding | Belirtilen başlık ve altbilgi ayarlarıyla birlikte, belirtilen bir satır bantlama temasını aralığa uygular. |
auto | void | destination değerini, bu aralıktaki verilere göre verilerle doldurur. |
auto | void | Komşu hücrelere göre yeni veri ile doldurulacak bir aralık hesaplar ve bu aralığı, bu aralıkta bulunan verilere göre otomatik olarak yeni değerlerle doldurur. |
break | Range | Aralıktaki çok sütunlu hücreleri tekrar tek hücrelere ayırın. |
can | Boolean | Kullanıcının, aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. |
check() | Range | Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. |
clear() | Range | İçerik ve biçim aralığını temizler. |
clear(options) | Range | Belirtilen ileri seviye seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler. |
clear | Range | Biçimlendirmeyi bozmadan aralığın içeriğini temizler. |
clear | Range | Aralıktaki veri doğrulama kurallarını temizler. |
clear | Range | Bu aralıktaki biçimlendirmeyi temizler. |
clear | Range | Belirli bir hücre veya hücrelerdeki notu temizler. |
collapse | Range | Tamamen aralık içinde bulunan tüm grupları daraltır. |
copy | void | Aralığın biçimlendirmesini belirtilen konuma kopyalar. |
copy | void | Aralığın biçimlendirmesini belirtilen konuma kopyalar. |
copy | void | Bir hücre aralığından başka bir hücre aralığına veri kopyalar. |
copy | void | Bir hücre aralığından başka bir hücre aralığına veri kopyalar. |
copy | void | Bir hücre aralığından başka bir hücre aralığına veri kopyalar. |
copy | void | Aralıktaki içeriği belirtilen konuma kopyalayın. |
copy | void | Aralıktaki içeriği belirtilen konuma kopyalayın. |
create | Data | Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur. |
create | Data | Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur. |
create | Developer | Bu aralık kapsamındaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi döndürür. |
create | Filter | Bir filtre oluşturur ve bu filtreyi sayfadaki belirtilen alana uygular. |
create | Pivot | Bu aralıktaki ilk hücreye sabitlenmiş, belirtilen source alanından boş bir pivot tablo oluşturur. |
create | Text | Aralık için bu aralıktaki metinleri bulup değiştirebilen bir metin bulucu oluşturur. |
delete | void | Bu hücre aralığını siler. |
expand | Range | Aralığı veya kontrol düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. |
getA1Notation() | String | A1 gösterimindeki aralığın dize açıklamasını döndürür. |
get | String | Aralıktaki sol üst hücrenin arka plan rengini döndürür (örneğin, '#ffffff' ). |
get | Color | Aralığın sol üst hücresinin arka plan rengini döndürür. |
get | Color[][] | Aralıktaki hücrelerin arka plan renklerini döndürür. |
get | String[][] | Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#ffffff' ). |
get | Banding[] | Bu aralıktaki hücrelere uygulanan tüm bantları döndürür. |
get | Range | Bir aralıktaki belirli bir hücreyi döndürür. |
get | Integer | Bu aralığın başlangıç sütun konumunu döndürür. |
get | Range | İçinde veri bulunan tüm bitişik hücreleri kapsayacak şekilde dört ana Direction yönünde genişletilmiş aralığın bir kopyasını döndürür. |
get | Range | Belirtilen boyut Dimension.ROWS ise Direction.UP ve Direction.DOWN , boyut Dimension.COLUMNS ise Direction.NEXT ve Direction.PREVIOUS olarak genişletilmiş aralığın bir kopyasını döndürür. |
get | Data | Aralıktaki ilk hücre için Data değerini veya hücre bir veri kaynağı formülü içermiyorsa null değerini döndürür. |
get | Data | Aralıktaki hücrelerin Data değerini döndürür. |
get | Data | Aralıkla kesişen tüm veri kaynağı pivot tablolarını alır. |
get | Data | Aralıkla kesişen tüm veri kaynağı tablolarını alır. |
get | String | Bu aralıktaki verilerin URL'sini döndürür. Bu URL, grafik ve sorgu oluşturmak için kullanılabilir. |
get | Data | Bu nesnenin içindeki verileri DataTable olarak döndürme. |
get | Data | Bu aralıktaki verileri DataTable olarak döndürür. |
get | Data | Aralığın sol üst hücresindeki veri doğrulama kuralını döndürür. |
get | Data | Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür. |
get | Developer | Bu aralıkla ilişkili geliştirici meta verilerini alır. |
get | String | Aralığın sol üst hücresindeki görüntülenen değeri döndürür. |
get | String[][] | Bu aralık için dikdörtgen değer ızgarasına döndürür. |
get | Filter | Bu aralığın ait olduğu sayfadaki filtreyi veya sayfada filtre yoksa null değerini döndürür. |
get | Color | Aralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür. |
get | Color[][] | Aralıktaki hücrelerin yazı tipi renklerini döndürür. |
get | String[][] | Aralıktaki hücrelerin yazı tipi ailelerini döndürür. |
get | String | Aralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür. |
get | String | Aralığın sol üst köşesindeki hücrenin çizgi stilini ('underline' , 'line-through' veya 'none' ) alır. |
get | String[][] | Aralıktaki hücrelerin çizgi stilini ('underline' , 'line-through' veya 'none' ) alır. |
get | Integer | Aralığın sol üst köşesindeki hücrenin yazı tipi boyutunu punto cinsinden döndürür. |
get | Integer[][] | Aralıktaki hücrelerin yazı tipi boyutlarını döndürür. |
get | String | Aralığın sol üst köşesindeki hücrenin yazı tipi stilini ('italic' veya 'normal' ) döndürür. |
get | String[][] | Aralıktaki hücrelerin yazı tipi stillerini döndürür. |
get | String | Aralığın sol üst köşesindeki hücrenin yazı tipi kalınlığını (normal/kalın) döndürür. |
get | String[][] | Aralıktaki hücrelerin yazı tipi ağırlıklarını döndürür. |
get | String | Aralıktaki sol üst hücrenin formülünü (A1 gösterimi) veya hücre boşsa ya da formül içermiyorsa boş bir dize döndürür. |
get | String | Belirli bir hücrenin formülünü (R1C1 gösterimi) veya formül yoksa null değerini döndürür. |
get | String[][] | Aralıktaki hücrelerin formüllerini (A1 gösterimi) döndürür. |
get | String[][] | Aralıktaki hücrelerin formüllerini (R1C1 gösterimi) döndürür. |
get | Integer | Aralıktaki üst sayfanın ızgara kimliğini döndürür. |
get | Integer | Aralığın yüksekliğini döndürür. |
get | String | Aralığın sol üst köşesindeki hücrenin metninin yatay hizalamasını (sol/orta/sağ) döndürür. |
get | String[][] | Aralıktaki hücrelerin yatay hizalamalarını döndürür. |
get | Integer | Son sütun konumunu döndürür. |
get | Integer | Son satır konumunu döndürür. |
get | Range[] | Tamamen geçerli aralık içinde olan veya geçerli aralıktaki en az bir hücreyi içeren birleştirilmiş hücreleri temsil eden bir Range nesne dizisi döndürür. |
get | Range | Aralığın ilk sütun ve satırındaki hücreden başlayarak, belirli bir yönde sonraki hücreyi döndürür. Bu hücre, içinde veri bulunan bitişik bir hücre aralığının kenarı veya elektronik tablonun o yönde kenarındaki hücredir. |
get | String | Belirtilen aralıkla ilişkili notu döndürür. |
get | String[][] | Aralıktaki hücrelerle ilişkili notları döndürür. |
get | Integer | Bu aralıktaki sütun sayısını döndürür. |
get | Integer | Bu aralıktaki satır sayısını döndürür. |
get | String | Belirtilen aralığın sol üst hücresinin sayı veya tarih biçimini alın. |
get | String[][] | Aralıktaki hücrelerin sayı veya tarih biçimlerini döndürür. |
get | Rich | Aralığın sol üst hücresinin zengin metin değerini veya hücre değeri metin değilse null değerini döndürür. |
get | Rich | Aralıktaki hücrelerin zengin metin değerlerini döndürür. |
get | Integer | Bu aralığın satır konumunu döndürür. |
get | Integer | Bu aralığın satır konumunu döndürür. |
get | Sheet | Bu aralığın ait olduğu sayfayı döndürür. |
get | Text | Aralıktaki sol üst hücrenin metin yönünü döndürür. |
get | Text | Aralıktaki hücreler için metin yönergelerini döndürür. |
get | Text | Aralıktaki sol üst hücrenin metin döndürme ayarlarını döndürür. |
get | Text | Aralıktaki hücrelerin metin döndürme ayarlarını döndürür. |
get | Text | Aralıktaki sol üst hücrenin metin stilini döndürür. |
get | Text | Aralıktaki hücrelerin metin stillerini döndürür. |
get | Object | Aralıktaki sol üst hücrenin değerini döndürür. |
get | Object[][] | Bu aralık için dikdörtgen değer ızgarasına döndürür. |
get | String | Aralıktaki sol üst köşedeki hücrenin dikey hizalamasını (üst/orta/alt) döndürür. |
get | String[][] | Aralıktaki hücrelerin dikey hizalamalarını döndürür. |
get | Integer | Aralığın sütunlardaki genişliğini döndürür. |
get | Boolean | Hücredeki metnin sarmalanıp sarmalanmadığını döndürür. |
get | Wrap | Aralıktaki hücreler için metin kaydırma stratejilerini döndürür. |
get | Wrap | Aralıktaki sol üst hücrenin metin kaydırma stratejisini döndürür. |
get | Boolean[][] | Hücrelerdeki metnin sarmalanıp sarmalanmadığını döndürür. |
insert | Range | Bu alana boş hücreler ekler. |
insert | Range | İşaretli için true ve işaretsiz için false ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler. |
insert | Range | İşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler. |
insert | Range | Aralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. |
is | Boolean | Aralık tamamen boşsa true döndürülür. |
is | Boolean | Aralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür. |
is | Boolean | Aralığın sonunun belirli bir sütuna bağlı olup olmadığını belirler. |
is | Boolean | Aralığın sonunun belirli bir satıra bağlı olup olmadığını belirler. |
is | Boolean | Geçerli aralıktaki hücreler birleştirilmiş hücrelerle örtüşüyorsa true değerini döndürür. |
is | Boolean | Aralığın başlangıcının belirli bir sütuna bağlı olup olmadığını belirler. |
is | Boolean | Aralığın başlangıcının belirli bir satıra bağlı olup olmadığını belirler. |
merge() | Range | Aralıktaki hücreleri tek bir blok halinde birleştirir. |
merge | Range | Aralığın sütunlarındaki hücreleri birleştirin. |
merge | Range | Aralıktaki hücreleri birleştirir. |
move | void | Bu aralığı (hem biçimi hem de değerleri) kesip hedef alana yapıştırın. |
offset(rowOffset, columnOffset) | Range | Bu aralıktan belirli sayıda satır ve sütun (negatif olabilir) uzaklıkta olan yeni bir aralık döndürür. |
offset(rowOffset, columnOffset, numRows) | Range | Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralıktan belirli satır ve sütunlar kadar uzaktadır ve hücrelerdeki yükseklik de belirlidir. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralığından belirli satır ve sütunlar kadar uzaktadır ve hücrelerde belirli bir yükseklik ve genişliğe sahiptir. |
protect() | Protection | İzin sahibi kullanıcılar dışındaki kullanıcıların düzenlemesini engelleyebilecek bir nesne oluşturur. |
randomize() | Range | Belirtilen aralıktaki satırların sırasını rastgele hale getirir. |
remove | Range | Aralıktaki tüm onay kutularını kaldırır. |
remove | Range | Bu aralıktaki, önceki bir satırdaki değerlerin yinelemesi olan değerleri içeren satırları kaldırır. |
remove | Range | Belirtilen sütunlarda önceki bir satırdaki değerlerin yinelemesini içeren, bu aralıktaki satırları kaldırır. |
set | Range | CSS notasyonunda ('#ffffff' veya 'white' gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar. |
set | Range | Aralıktaki tüm hücrelerin arka plan rengini ayarlar. |
set | Range | Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | RGB değerlerini (0 ile 255 dahili tam sayılar) kullanarak arka planı belirtilen renge ayarlar. |
set | Range | Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Kenarlık özelliğini ayarlar. |
set | Range | Kenarlık özelliğini renk ve/veya stil ile ayarlar. |
set | Range | Aralıktaki tüm hücreler için bir veri doğrulama kuralı belirler. |
set | Range | Aralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar. |
set | Range | Yazı tipi rengini CSS notasyonunda ('#ffffff' veya 'white' gibi) ayarlar. |
set | Range | Belirtilen aralığın yazı tipi rengini ayarlar. |
set | Range | Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Yazı tipi ailelerinden dikdörtgen bir ızgara oluşturur (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | "Arial" veya "Helvetica" gibi yazı tipi ailesini ayarlar. |
set | Range | Belirtilen aralığın yazı tipi çizgi stilini ('underline' , 'line-through' veya 'none' ) belirler. |
set | Range | Dikdörtgen bir çizgi stili ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Yazı tipi boyutunu belirler. Boyut, kullanılacak punto boyutudur. |
set | Range | Yazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Belirtilen aralık için yazı tipi stilini ayarlayın ('italic' veya 'normal' ). |
set | Range | Yazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Belirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın. |
set | Range | Yazı tipi kalınlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Bu aralıktaki formülü günceller. |
set | Range | Bu aralıktaki formülü günceller. |
set | Range | Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Belirtilen aralık için yatay (soldan sağa) hizalamayı (sol/orta/sağ) ayarlayın. |
set | Range | Yatay hizalamalarla dikdörtgen bir ızgara oluşturur. |
set | Range | Notu belirtilen değere ayarlar. |
set | Range | Dikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Sayı veya tarih biçimini belirtilen biçimlendirme dizesine ayarlar. |
set | Range | Sayı veya tarih biçimlerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Aralıktaki hücreler için zengin metin değerini ayarlar. |
set | Range | Zengin metin değerlerinin dikdörtgen bir ızgarasına ayarlanır. |
set | Range | Aralığın köprüleri gösterip göstermeyeceğini belirler. |
set | Range | Aralıktaki hücrelerin metin yönünü belirler. |
set | Range | Metin yönlerinden oluşan dikdörtgen bir ızgara ayarlar. |
set | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
set | Range | Aralıktaki hücreler için metin döndürme ayarlarını belirler. |
set | Range | Metin rotasyonlarından oluşan dikdörtgen bir ızgara ayarlar. |
set | Range | Aralıktaki hücrelerin metin stilini ayarlar. |
set | Range | Metin stillerinden oluşan dikdörtgen bir ızgara oluşturur. |
set | Range | Aralığın değerini ayarlar. |
set | Range | Dikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Belirtilen aralık için dikey (üstten alta) hizalamayı (üst/orta/alt) ayarlayın. |
set | Range | Dikey hizalamalarla dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
set | Range | Aralıktaki hücrelerin metninin yığın halinde gösterilip gösterilmeyeceğini belirler. |
set | Range | Belirtilen aralığın hücre sarma özelliğini ayarlayın. |
set | Range | Dikdörtgen bir sarma stratejisi ızgarası ayarlar. |
set | Range | Aralıktaki hücreler için metin kaydırma stratejisini belirler. |
set | Range | Satır sonu politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). |
shift | Range | Aralığın sütun gruplandırma derinliğini belirtilen miktar kadar değiştirir. |
shift | Range | Aralığın satır gruplandırma derinliğini belirtilen miktarda değiştirir. |
sort(sortSpecObj) | Range | Belirtilen aralıktaki hücreleri, sütuna ve belirtilen sıraya göre sıralar. |
split | void | Otomatik olarak algılanan bir sınırlayıcıya göre bir metin sütununu birden çok sütuna böler. |
split | void | Belirtilen dizeyi özel ayırıcı olarak kullanarak bir metin sütununu birden çok sütuna böler. |
split | void | Belirtilen sınırlayıcıya göre bir metin sütununu birden çok sütuna böler. |
trim | Range | Bu aralıktaki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar. |
uncheck() | Range | Aralıktaki onay kutularının durumunu "onaysız" olarak değiştirir. |
Ayrıntılı dokümanlar
activate()
Belirtilen aralığı active range
olarak, aralığın sol üst hücresini ise current cell
olarak ayarlar.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:D10'); range.activate(); const selection = sheet.getSelection(); // Current cell: A1 const currentCell = selection.getCurrentCell(); // Active Range: A1:D10 const activeRange = selection.getActiveRange();
Return
Range
: Zincirleme için bu aralık.
activate As Current Cell()
Belirtilen hücreyi current cell
olarak ayarlar.
Belirtilen hücre mevcut bir aralıktaysa bu aralık, hücrenin geçerli hücre olduğu etkin aralık olur.
Belirtilen hücre mevcut bir aralıkta yoksa mevcut seçim 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.
// Gets the first sheet of the spreadsheet. const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. const range = sheet.getRange('B5'); const currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
Return
Range
: Zincirleme için bu 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
add Developer Metadata(key)
Belirtilen anahtarla geliştirici meta verilerini aralığa ekler.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME' to the developer metadata for row 2. range.addDeveloperMetadata('NAME'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
Return
Range
: Zincirleme için bu 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
add Developer Metadata(key, visibility)
Belirtilen anahtar ve görünürlükle geliştirici meta verilerini aralığa ekler.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT' // for row 2 on Sheet1. range.addDeveloperMetadata( 'NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT, ); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Range
: Zincirleme için bu 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
add Developer Metadata(key, value)
Belirtilen anahtar ve değere sahip geliştirici meta verilerini aralığa ekler.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
Return
Range
: Zincirleme için bu 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
add Developer Metadata(key, value, visibility)
Belirtilen anahtar, değer ve görünürlükle geliştirici meta verilerini alana ekler.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to PROJECT for row 2 on the sheet. range.addDeveloperMetadata( 'NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT, ); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
key | String | Yeni geliştirici meta verilerinin anahtarı. |
value | String | Yeni geliştirici meta verisinin değeri. |
visibility | Developer | Yeni geliştirici meta verisinin görünürlüğü. |
Return
Range
: Zincirleme için bu 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
apply Column Banding()
Aralıka varsayılan bir sütun bantları teması uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies column banding to row 2. const colBanding = range.applyColumnBanding(); // Gets the first banding on the sheet and logs the color of the header column. console.log( sheet.getBandings()[0] .getHeaderColumnColorObject() .asRgbColor() .asHexString(), ); // Gets the first banding on the sheet and logs the color of the second column. console.log( sheet.getBandings()[0] .getSecondColumnColorObject() .asRgbColor() .asHexString(), );
Return
Banding
: Yeni bant.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Column Banding(bandingTheme)
Belirtilen bir sütun bantlama temasını aralığa uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies the INDIGO color banding theme to the columns in row 2. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the first banding on the sheet and logs the color of the second column. console.log( sheet.getBandings()[0] .getSecondColumnColorObject() .asRgbColor() .asHexString(), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
banding | Banding | Aralıktaki sütunlara uygulanacak renk teması. |
Return
Banding
: Yeni bant.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Column Banding(bandingTheme, showHeader, showFooter)
Belirtilen sütun bantlama temasını, belirtilen başlık ve altbilgi ayarlarıyla aralığa uygular.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 12-22 on the sheet. const range = sheet.getRange('12:22'); // Applies the BLUE color banding theme to rows 12-22. // Sets the header visibility to false and the footer visibility to true. const colBanding = range.applyColumnBanding( SpreadsheetApp.BandingTheme.BLUE, false, true, ); // Gets the banding color and logs it to the console. console.log( sheet.getBandings()[0] .getSecondColumnColorObject() .asRgbColor() .asHexString(), ); // Gets the header color object and logs it to the console. Returns null because // the header visibility is set to false. console.log(sheet.getBandings()[0].getHeaderColumnColorObject()); // Gets the footer color and logs it to the console. console.log( sheet.getBandings()[0] .getFooterColumnColorObject() .asRgbColor() .asHexString(), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
banding | Banding | Aralıktaki sütunlara uygulanacak renk teması. |
show | Boolean | true ise bant tema başlığı rengi ilk sütuna uygulanır. |
show | Boolean | true ise bant temalı altbilgi rengi son sütuna uygulanır. |
Return
Banding
: Yeni bant.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding()
Aralıka varsayılan bir satır gruplandırma teması uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.
// Opens the spreadsheet 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 rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Return
Banding
: Alternatif arka plan rengi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding(bandingTheme)
Belirtilen satır gruplandırma temasını aralığa uygular. Varsayılan olarak, bantlarda başlık rengi bulunur ve altbilgi rengi yoktur.
// Opens the spreadsheet 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 rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0].getSecondRowColorObject().asRgbColor().asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
banding | Banding | Aralıktaki satırlara uygulanacak renk teması. |
Return
Banding
: Yeni bant.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
apply Row Banding(bandingTheme, showHeader, showFooter)
Belirtilen başlık ve altbilgi ayarlarıyla birlikte, belirtilen bir satır bantlama temasını aralığa uygular.
// Opens the spreadsheet 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 rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
banding | Banding | Aralıktaki satırlara uygulanacak renk teması. |
show | Boolean | true ise bant tema başlığı rengi ilk satıra uygulanır. |
show | Boolean | true ise bant tema altbilgi rengi son satıra uygulanır. |
Return
Banding
: Yeni bant.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Fill(destination, series)
destination
değerini, bu aralıktaki verilere göre verilerle doldurur. Yeni değerler, belirtilen series
türüne göre de belirlenir. Hedef aralık bu aralığı içermeli ve yalnızca tek bir yönde genişletmelidir. Örneğin, aşağıdaki ifade A1:A20
A1:A4
'daki mevcut değerlere göre artan bir sayı dizisiyle doldurur:
const sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. const sourceRange = sheet.getRange('A1:A4'); // The range to fill with values. const destination = sheet.getRange('A1:A20'); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Değerlerle otomatik olarak doldurulacak aralık. Hedef aralık bu aralığı içermeli ve yalnızca tek bir yönde (yukarı, aşağı, sola veya sağa) genişletmelidir. |
series | Auto | Yeni değerleri hesaplamak için kullanılması gereken otomatik doldurma serisinin türü. Bu serinin etkisi, kaynak verilerin türüne ve miktarına göre değişir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Fill To Neighbor(series)
Komşu hücrelere göre yeni veri ile doldurulacak bir aralık hesaplar ve bu aralığı, bu aralıkta bulunan verilere göre otomatik olarak yeni değerlerle doldurur. Bu yeni değerler, belirtilen series
türüne göre de belirlenir.
Hesaplanan hedef aralık, yeni değerlerin nereye ekleneceğini belirlemek için çevredeki verileri dikkate alır: Otomatik olarak doldurulan bir sütunun hemen solunda veya sağında veri varsa yeni değerler yalnızca bu bitişik verilere kadar uzanır.
Örneğin, A1:A20
bir dizi artan sayıyla doldurulmuşsa ve bu yöntem bir dizi tarih içeren B1:B4
aralığında çağrılırsa yeni değerler yalnızca B5:B20
alanına eklenir. Bu sayede bu yeni değerler, A sütunundaki değerleri içeren hücrelere "yapışır".
const sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] const sourceRange = sheet.getRange('B1:B4'); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
series | Auto | Yeni değerleri hesaplamak için kullanılması gereken otomatik doldurma serisinin türü. Bu serinin etkisi, kaynak verilerin türüne ve miktarına göre değişir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
break Apart()
Aralıktaki çok sütunlu hücreleri tekrar tek hücrelere ayırın.
Bu işlevi bir aralık üzerinde çağırmak, bir aralık seçip Biçim > Hücreleri birleştir > Birleştirmeyi kaldır'ı tıklamakla aynıdır.
// Opens the spreadsheet 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 range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
Return
Range
: Zincirleme için bu 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
can Edit()
Kullanıcının, aralıktaki her hücreyi düzenleme izni olup olmadığını belirler. E-tablonun sahibi, korunan aralıkları ve sayfaları her zaman düzenleyebilir.
// Opens the spreadsheet 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 range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
Return
Boolean
: Kullanıcının aralıktaki her hücreyi düzenleme izni varsa 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
check()
Aralıktaki onay kutularının durumunu "işaretli" olarak değiştirir. Aralıktaki, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the range A1:B10 to 'checked'. const range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
Return
Range
: Zincirleme için bu 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
clear()
İçerik ve biçim aralığını temizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clear();
Return
Range
: Zincirleme için bu 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
clear(options)
Belirtilen ileri seviye seçeneklerle belirtildiği şekilde içerik aralığını, biçimi, veri doğrulama kurallarını ve/veya yorumları temizler. Varsayılan olarak tüm veriler temizlenir.
// The code below clears range C2:G7 in the active sheet, but preserves the // format, data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({ contentsOnly: true });
Parametreler
Ad | Tür | Açıklama |
---|---|---|
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
comments | Boolean | Yalnızca yorumların temizlenip temizlenmeyeceğini belirtir. |
contents | Boolean | Yalnızca içeriğin temizlenip temizlenmeyeceği. |
format | Boolean | Yalnızca biçimin temizlenip temizlenmeyeceği. Biçimin temizlenmesinin veri doğrulama kurallarının da temizlendiğini unutmayın. |
validations | Boolean | Yalnızca veri doğrulama kurallarının temizlenip temizlenmeyeceği. |
skip | Boolean | Filtrelenmiş satırların temizlenip temizlenmeyeceği. |
Return
Range
: Zincirleme için bu 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
clear Content()
Biçimlendirmeyi bozmadan aralığın içeriğini temizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearContent();
Return
Range
: Zincirleme için bu 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
clear Data Validations()
Aralıktaki veri doğrulama kurallarını temizler.
// Clear the data validation rules for cells A1:B5. const range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
Return
Range
: Zincirleme için bu 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
clear Format()
Bu aralıktaki biçimlendirmeyi temizler.
Bu işlem, aralıkta bulunan hücre veya hücrelerin metin biçimlendirmesini temizler ancak sayı biçimlendirme kurallarını sıfırlamaz.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearFormat();
Return
Range
: Zincirleme için bu 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
clear Note()
Belirli bir hücre veya hücrelerdeki notu temizler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.clearNote();
Return
Range
: Zincirleme için bu 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
collapse Groups()
Tamamen aralık içinde bulunan tüm grupları daraltır. Hiçbir grup tamamen aralık içinde değilse kısmen aralık içinde olan en derin genişletilmiş grup daraltılır.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Return
Range
: Zincirleme için bu 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
copy Format To Range(gridId, column, columnEnd, row, rowEnd)
Aralığın biçimlendirmesini belirtilen konuma kopyalar. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır. Bu yöntemin yalnızca biçimlendirmeyi kopyaladığını unutmayın.
gridId parametresinin ayrıntılı açıklaması için get
bölümüne bakın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const range = source.getRange('B2:D4'); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
grid | Integer | Konumdan bağımsız olarak e-tablodaki sayfanın benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
column | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
row | Integer | Hedef aralığın 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
Aşağıdaki kaynakları da incelemenizi öneririz:
copy Format To Range(sheet, column, columnEnd, row, rowEnd)
Aralığın biçimlendirmesini belirtilen konuma kopyalar. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır. Bu yöntemin yalnızca biçimlendirmeyi kopyaladığını unutmayın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const destination = ss.getSheets()[1]; const range = source.getRange('B2:D4'); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfası. |
column | Integer | Hedef aralığın ilk sütunu. |
column | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
row | Integer | Hedef aralığın 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
copy To(destination)
Bir hücre aralığından başka bir hücre aralığına veri kopyalar. Hem değerler hem de biçimlendirme kopyalanır.
// The code below copies the first 5 columns over to the 6th column. const sheet = SpreadsheetApp.getActiveSheet(); const rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(destination, copyPasteType, transposed)
Bir hücre aralığından başka bir hücre aralığına veri kopyalar.
// The code below copies only the values of the first 5 columns over to the 6th // column. const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A:E').copyTo( sheet.getRange('F1'), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false, );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir. |
copy | Copy | Aralık içeriğinin hedefe nasıl yapıştırıldığını belirten bir tür. |
transposed | Boolean | Aralığın, transpoze edilmiş yönde yapıştırılıp yapıştırılmayacağını belirtir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copy To(destination, options)
Bir hücre aralığından başka bir hücre aralığına veri kopyalar. Varsayılan olarak hem değerler hem de biçimlendirme kopyalanır ancak bu, gelişmiş bağımsız değişkenler kullanılarak geçersiz kılınabilir.
// The code below copies only the values of the first 5 columns over to the 6th // column. const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A:E').copyTo(sheet.getRange('F1'), {contentsOnly: true});
Parametreler
Ad | Tür | Açıklama |
---|---|---|
destination | Range | Kopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir. |
options | Object | Aşağıda listelenen gelişmiş parametreleri belirten bir JavaScript nesnesi. |
Gelişmiş parametreler
Ad | Tür | Açıklama |
---|---|---|
format | Boolean | yalnızca biçimin kopyalanacağını belirtir |
contents | Boolean | Yalnızca içeriğin kopyalanacağını belirtir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Values To Range(gridId, column, columnEnd, row, rowEnd)
Aralıktaki içeriği belirtilen konuma kopyalayın. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır.
gridId parametresinin ayrıntılı açıklaması için get
bölümüne bakın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const range = source.getRange('B2:D4'); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
grid | Integer | Konumdan bağımsız olarak e-tablodaki sayfanın benzersiz kimliği. |
column | Integer | Hedef aralığın ilk sütunu. |
column | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
row | Integer | Hedef aralığın 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
Aşağıdaki kaynakları da incelemenizi öneririz:
copy Values To Range(sheet, column, columnEnd, row, rowEnd)
Aralıktaki içeriği belirtilen konuma kopyalayın. Hedef, kaynak aralığından daha büyük veya daha küçükse kaynak buna göre tekrarlanır ya da kısaltılır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const source = ss.getSheets()[0]; const destination = ss.getSheets()[1]; const range = source.getRange('B2:D4'); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sheet | Sheet | Hedef sayfası. |
column | Integer | Hedef aralığın ilk sütunu. |
column | Integer | Hedef aralığın bitiş sütunu. |
row | Integer | Hedef aralığın başlangıç satırı. |
row | Integer | Hedef aralığın 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
create Data Source Pivot Table(dataSource)
Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı pivot tablosu oluşturur.
Bu örnekte, yeni bir veri kaynağı pivot tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const anchorCell = spreadsheet.getSheets()[0].getRange('A1'); const dataSource = spreadsheet.getDataSources()[0]; const pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue( 'dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM, ); pivotTable.addFilter( 'dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build(), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
data | Data | Pivot tablonun oluşturulacağı veri kaynağı. |
Return
Data
: Yeni oluşturulan veri kaynağı pivot tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Data Source Table(dataSource)
Veri kaynağından, bu aralıktaki ilk hücreye sabitlenmiş boş bir veri kaynağı tablosu oluşturur.
Bu örnekte, yeni bir veri kaynağı tablosunun nasıl oluşturulacağı ve yapılandırılacağı gösterilmektedir.
const spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); const anchorCell = spreadsheet.getSheets()[0].getRange('A1'); const dataSource = spreadsheet.getDataSources()[0]; const dataSourceTable = anchorCell.createDataSourceTable(dataSource) .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', true) // ascending=true .addSortSpec('dataColumnB', false); // ascending=false
Parametreler
Ad | Tür | Açıklama |
---|---|---|
data | Data | Pivot tablonun oluşturulacağı veri kaynağı. |
Return
Data
: Yeni oluşturulan veri kaynağı tablosu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 aralık kapsamındaki geliştirici meta verilerini bulmak için bir DeveloperMetadataFinderApi döndürür. Meta veriler yalnızca tamamen bu aralıkta yer alıyorsa aralığın kapsamındadır. Örneğin, "3:3" satırıyla ilişkili meta veriler "A1:D5" aralığının kapsamında değil, "1:5" aralığının kapsamındadır.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6. const range = sheet.getRange('A1:C6'); // Creates a developer metadata finder to search for metadata in the scope of // this range. const developerMetaDataFinder = range.createDeveloperMetadataFinder(); // Logs information about the developer metadata finder to the console. const developerMetaData = developerMetaDataFinder.find()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Return
Developer
: Bu aralık kapsamında meta veri aramak için bir geliştirici meta veri bulucusu.
create Filter()
Bir filtre oluşturur ve bu filtreyi sayfadaki belirtilen alana uygular. Bir sayfada birden fazla filtre oluşturamazsınız. Oluşturduğunuz filtreye erişmek ve filtreyi değiştirmek için get
veya Sheet.getFilter()
simgesini kullanın.
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { const filter = range.getFilter(); const criteria = SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build(); filter.setColumnFilterCriteria(2, criteria); }Varsayılan e-tablo türü olan
Grid
e-tabloları için filtre oluşturmak üzere bu yöntemi kullanın.
Tablo sayfaları, bir veritabanına bağlı olmayan sayfalardır. Diğer filtre türlerini oluşturmak için aşağıdakilere bakın:
Pivot
ile pivot tablo filtresi oluşturmaTable.addFilter(sourceDataColumn, filterCriteria) Data
ile veritabanına bağlı bir sayfa için filtre oluşturmaSource Sheet.addFilter(columnName, filterCriteria) Data
ile bir veritabanına bağlı pivot tablo için filtre oluşturmaSource Pivot Table.addFilter(columnName, filterCriteria)
Return
Filter
: Yeni filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
create Pivot Table(sourceData)
Bu aralıktaki ilk hücreye sabitlenmiş, belirtilen source
alanından boş bir pivot tablo oluşturur.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 as a range in order to place the pivot table. const range = sheet.getRange('A1'); // Gets the range of the source data for the pivot table. const dataRange = sheet.getRange('E12:G20'); // Creates an empty pivot table from the specified source data. const pivotTable = range.createPivotTable(dataRange); // Logs the values from the pivot table's source data to the console. console.log(pivotTable.getSourceDataRange().getValues());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
source | Range | Pivot tablonun oluşturulacağı veriler. |
Return
Pivot
: Yeni oluşturulan Pivot
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Text Finder(findText)
Aralık için bu aralıktaki metinleri bulup değiştirebilen bir metin bulucu oluşturur.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // Creates a text finder for the range. const textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. const firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. const numOccurrencesReplaced = textFinder.replaceWith('cat');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
find | String | Aranacak metin. |
Return
Text
: Aralık için Text
delete Cells(shiftDimension)
Bu hücre aralığını siler. Sayfada, belirtilen boyut boyunca mevcut veriler silinen aralığa doğru kaydırılır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
shift | Dimension | Mevcut verilerin kaydırıldığı boyut. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand Groups()
Aralığı veya kontrol düğmesi bu aralıkla kesişen daraltılmış grupları genişletir. Kontrol düğmesi konumu, ayarlara bağlı olarak kontrol düğmesinin gösterildiği dizindir (doğrudan gruptan önce veya sonra). Aynı konumda birden fazla grup varsa en sığ grup genişletilir.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Return
Range
: Zincirleme için bu 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
getA1Notation()
A1 gösterimindeki aralığın dize açıklamasını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
Return
String
: A1 gösterimindeki aralığın dize açıklaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Background()
Aralıktaki sol üst hücrenin arka plan rengini döndürür (örneğin, '#ffffff'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); Logger.log(cell.getBackground());
Return
String
: Arka planın renk kodu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Background Object()
Aralığın sol üst hücresinin arka plan rengini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Return
Color
: Aralığın sol üst hücresinin arka plan rengi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Background Objects()
Aralıktaki hücrelerin arka plan renklerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const bgColors = range.getBackgroundObjects(); for (const i in bgColors) { for (const j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
Return
Color[][]
: İki boyutlu bir arka plan rengi 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 Backgrounds()
Aralıktaki hücrelerin arka plan renklerini döndürür (örneğin, '#ffffff'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const bgColors = range.getBackgrounds(); for (const i in bgColors) { for (const j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
Return
String[][]
: Arka planların renk kodlarından oluşan iki boyutlu 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 Bandings()
Bu aralıktaki hücrelere uygulanan tüm bantları döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (const banding of bandings) { console.log(banding.getSecondRowColor()); }
Return
Banding[]
: Bu aralıktaki hücrelere uygulanan tüm bantlar.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Cell(row, column)
Bir aralıktaki belirli bir hücreyi döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 const cell = range.getCell(1, 1); Logger.log(cell.getValue());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Hücrenin aralığa göre satır numarası. |
column | Integer | Hücrenin aralığa göre sütunu. |
Return
Range
: Belirtilen koordinatlarda tek bir hücre içeren bir aralık.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Column()
Bu aralığın başlangıç sütun konumunu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // Logs "2.0" Logger.log(range.getColumn());
Return
Integer
: Aralığın e-tablodaki başlangıç sütunu konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Region()
İçinde veri bulunan tüm bitişik hücreleri kapsayacak şekilde dört ana Direction
yönünde genişletilmiş aralığın bir kopyasını döndürür. Aralık, köşegenler boyunca olanlar hariç boş hücrelerle çevriliyse aralığın kendisi döndürülür. Bu, aralığı seçip düzenleyicide Ctrl+A
yazmaya benzer.
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.getRange('C2').setValue(100); sheet.getRange('B3').setValue(100); sheet.getRange('D3').setValue(100); sheet.getRange('C4').setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange('C3').getDataRegion().getA1Notation());
Return
Range
: Aralığın veri bölgesi veya e-tablonun tamamı için 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 Region(dimension)
Belirtilen boyut Dimension.ROWS
ise Direction.UP
ve Direction.DOWN
, boyut Dimension.COLUMNS
ise Direction.NEXT
ve Direction.PREVIOUS
olarak genişletilmiş aralığın bir kopyasını döndürür. Aralığın genişletilmesi, aralığın yanında tablo gibi düzenlenmiş verilerin algılanmasına dayanır. Genişletilmiş aralık, tablo sınırları da dahil olmak üzere belirtilen boyut boyunca veri içeren tüm bitişik hücreleri kapsar. Orijinal aralık, belirtilen boyut boyunca boş hücrelerle çevriliyse aralığın kendisi döndürülür. Bu yöntem, aralığı seçip düzenleyicide sütunlar için
Ctrl+Space
veya satırlar için Shift+Space
yazmaya benzer.
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; sheet.getRange('C2').setValue(100); sheet.getRange('B3').setValue(100); sheet.getRange('D3').setValue(100); sheet.getRange('C4').setValue(100); // Logs "C2:C4" Logger.log( sheet.getRange('C3') .getDataRegion(SpreadsheetApp.Dimension.ROWS) .getA1Notation(), ); // Logs "B3:D3" Logger.log( sheet.getRange('C3') .getDataRegion(SpreadsheetApp.Dimension.COLUMNS) .getA1Notation(), );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
dimension | Dimension | Aralığın genişletileceği boyut. |
Return
Range
: Aralığın veri bölgesi veya orijinal aralık tarafından kapsanan her sütunu ya da her satırı kapsayan 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 Formula()
Aralıktaki ilk hücre için Data
değerini veya hücre bir veri kaynağı formülü içermiyorsa null
değerini döndürü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 the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
Return
Data
: Hücrenin Data
değeri.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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()
Aralıktaki hücrelerin Data
değerini döndürü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 the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
Return
Data
: Data
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 Pivot Tables()
Aralıkla kesişen 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 the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Return
Data
: Veri kaynağı pivot tablolarının listesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Data Source Tables()
Aralıkla kesişen 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 the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.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 Source Url()
Bu aralıktaki verilerin URL'sini döndürür. Bu URL, grafik ve sorgu oluşturmak için kullanılabilir.
Code.gs
function doGet() { const ss = SpreadsheetApp.openById( '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c', ); const sheet = ss.getSheetByName('ContinentData'); const range = sheet.getRange('A1:B8'); const template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
Return
String
: Grafikler gibi diğer API'lere iletilebilecek bir veri kaynağı olarak bu aralık için bir URL.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Table()
Bu nesnenin içindeki verileri DataTable olarak döndürme.
// 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 the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of // the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use // sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
Return
Data
: Veriler, veri tablosu olarak.
get Data Table(firstRowIsHeader)
Bu aralıktaki verileri DataTable olarak döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B7'); // Calling this method with "true" sets the first line to be the title of the // axes const datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Title Here') .build();
Parametreler
Ad | Tür | Açıklama |
---|---|---|
first | Boolean | İlk satırın başlık olarak değerlendirilip değerlendirilmeyeceği. |
Return
Data
: Veriler, veri tablosu olarak.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Validation()
Aralığın sol üst hücresindeki veri doğrulama kuralını döndürür. Hücrede veri doğrulama ayarlanmamışsa bu yöntem null
değerini döndürür.
// Log information about the data validation rule for cell A1. const cell = SpreadsheetApp.getActive().getRange('A1'); const rule = cell.getDataValidation(); if (rule != null) { const criteria = rule.getCriteriaType(); const args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.'); }
Return
Data
: Aralığın sol üst hücresi için veri doğrulama kuralı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Validations()
Aralıktaki tüm hücreler için veri doğrulama kurallarını döndürür. Belirli bir hücrede veri doğrulama ayarlanmamışsa bu yöntem, söz konusu hücrenin dizindeki konumu için null
döndürür.
// Change existing data validation rules that require a date in 2013 to require // a date in 2014. const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; const newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); const rules = range.getDataValidations(); for (let i = 0; i < rules.length; i++) { for (let j = 0; j < rules[i].length; j++) { const rule = rules[i][j]; if (rule != null) { const criteria = rule.getCriteriaType(); const args = rule.getCriteriaValues(); if (criteria === SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() === oldDates[0].getTime() && args[1].getTime() === oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Return
Data
: Aralıktaki hücrelerle ilişkili iki boyutlu bir veri doğrulama kuralı dizisidir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Developer Metadata()
Bu aralıkla 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 file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
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 Display Value()
Aralığın sol üst hücresindeki görüntülenen değeri döndürür. Değer bir String
olmalıdır.
Gösterilen değer, e-tablonun yerel ayarıyla otomatik olarak uygulanan biçimler dahil olmak üzere tarih, saat ve para birimi biçimlendirmesini dikkate alır. Boş hücreler boş bir dize döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
Return
String
: Bu hücrede gösterilen değerdir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Display Values()
Bu aralık için dikdörtgen değer ızgarasına döndürür.
Gösterilen değerlerin, satır ve sütuna göre dizine eklenen iki boyutlu bir dizisini döndürür. Değerler String
nesneleridir. Gösterilen değer, e-tablonun yerel ayarıyla otomatik olarak uygulanan biçimler dahil olmak üzere tarih, saat ve para birimi biçimlendirmesini dikkate alır. Boş hücreler, dizede boş bir dizeyle temsil edilir. Aralık dizininin 1, 1
ile başladığını, JavaScript dizisinin ise [0][0]
ile dizine eklendiğini unutmayın.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
Return
String[][]
: İki 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 Filter()
Bu aralığın ait olduğu sayfadaki filtreyi veya sayfada filtre yoksa null
değerini döndürür.
const ss = SpreadsheetApp.getActiveSheet(); const range = ss.getRange('A1:C20'); // Gets the existing filter on the sheet that the given range belongs to. const filter = range.getFilter();
Return
Filter
: Filtre.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Font Color Object()
Aralığın sol üst köşesindeki hücrenin yazı tipi rengini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
Return
Color
: Aralıktaki sol üst hücrenin yazı tipi rengi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Font Color Objects()
Aralıktaki hücrelerin yazı tipi renklerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontColorObjects(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
Return
Color[][]
: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi rengi 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 Font Families()
Aralıktaki hücrelerin yazı tipi ailelerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontFamilies(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi ailesi 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 Font Family()
Aralığın sol üst köşesindeki hücrenin yazı tipi ailesini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontFamily());
Return
String
: Hücrenin yazı tipi ailesi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Font Line()
Aralığın sol üst köşesindeki hücrenin çizgi stilini ('underline'
, 'line-through'
veya 'none'
) alır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontLine());
Return
String
: Yazı tipi 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 Font Lines()
Aralıktaki hücrelerin çizgi stilini ('underline'
, 'line-through'
veya 'none'
) alır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontLines(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili iki boyutlu bir yazı tipi satırı 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 Font Size()
Aralığın sol üst köşesindeki hücrenin yazı tipi boyutunu punto cinsinden döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontSize());
Return
Integer
: Punto boyutunda yazı tipi boyutu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Font Sizes()
Aralıktaki hücrelerin yazı tipi boyutlarını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontSizes(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
Integer[][]
: Aralıktaki hücrelerle ilişkili metinlerin yazı tipi boyutlarından oluşan iki boyutlu 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 Font Style()
Aralığın sol üst köşesindeki hücrenin yazı tipi stilini ('italic'
veya 'normal'
) döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontStyle());
Return
String
: Hücredeki metnin yazı tipi stili.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Font Styles()
Aralıktaki hücrelerin yazı tipi stillerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontStyles(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili metin yazı tipi stillerinin iki boyutlu 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 Font Weight()
Aralığın sol üst köşesindeki hücrenin yazı tipi kalınlığını (normal/kalın) döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getFontWeight());
Return
String
: Hücredeki metnin yazı tipi ağırlığı.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Font Weights()
Aralıktaki hücrelerin yazı tipi ağırlıklarını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getFontWeights(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili metinlerin yazı tipi ağırlıklarından oluşan iki boyutlu 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 Formula()
Aralıktaki sol üst hücrenin formülünü (A1 gösterimi) veya hücre boşsa ya da formül içermiyorsa boş bir dize döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 const range = sheet.getRange('B5'); // Logs the calculated value and the formula Logger.log( 'Calculated value: %s Formula: %s', range.getValue(), range.getFormula(), );
Return
String
: Hücrenin formü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
get Formula R1C1()
Belirli bir hücrenin formülünü (R1C1 gösterimi) veya formül yoksa null
değerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5'); const formula = range.getFormulaR1C1(); Logger.log(formula);
Return
String
: R1C1 gösterimindeki formü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
get Formulas()
Aralıktaki hücrelerin formüllerini (A1 gösterimi) döndürür. 2D dizideki girişler, formül içermeyen hücreler için boş dizelerdir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formulas = range.getFormulas(); for (const i in formulas) { for (const j in formulas[i]) { Logger.log(formulas[i][j]); } }
Return
String[][]
: Dize biçiminde iki boyutlu bir formül 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 Formulas R1C1()
Aralıktaki hücrelerin formüllerini (R1C1 gösterimi) döndürür. 2D dizideki girişler, formül içermeyen hücreler için null
olur.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formulas = range.getFormulasR1C1(); for (const i in formulas) { for (const j in formulas[i]) { Logger.log(formulas[i][j]); } }
Return
String[][]
: R1C1 gösterimindeki iki boyutlu bir formül 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 Grid Id()
Aralıktaki üst sayfanın ızgara kimliğini döndürür. Kimlikler, sıfırdan büyük rastgele tam sayı değerleridir.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getGridId());
Return
Integer
: Üst sayfanın ızgara 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 Height()
Aralığın yüksekliğini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // logs 3.0 Logger.log(range.getHeight());
Return
Integer
: Aralık 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 Horizontal Alignment()
Aralığın sol üst köşesindeki hücrenin metninin yatay hizalamasını (sol/orta/sağ) döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getHorizontalAlignment());
Return
String
: Hücredeki metnin yatay hizalaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Horizontal Alignments()
Aralıktaki hücrelerin yatay hizalamalarını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getHorizontalAlignments(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili metinlerin yatay hizalamalarının iki boyutlu 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 Last Column()
Son sütun konumunu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // Logs "4.0" Logger.log(range.getLastColumn());
Return
Integer
: Aralığın e-tablodaki bitiş sütunu konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Last Row()
Son satır konumunu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); // Logs "4.0" Logger.log(range.getLastRow());
Return
Integer
: Aralığın e-tablodaki bitiş satır konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Merged Ranges()
Tamamen geçerli aralık içinde olan veya geçerli aralıktaki en az bir hücreyi içeren birleştirilmiş hücreleri temsil eden bir Range
nesne dizisi döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B3'); const mergedRanges = range.getMergedRanges(); for (let i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
Return
Range[]
: Aralıkla örtüşen birleştirilmiş hücreleri temsil eden bir Range
nesnesi dizisi.
get Next Data Cell(direction)
Aralığın ilk sütun ve satırındaki hücreden başlayarak, belirli bir yönde sonraki hücreyi döndürür. Bu hücre, içinde veri bulunan bitişik bir hücre aralığının kenarı veya elektronik tablonun o yönde kenarındaki hücredir. Bu, düzenleyicide
Ctrl+[arrow key]
yazılmasına eşdeğerdir.
// Assume the active spreadsheet is blank. const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('C3:E5'); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
direction | Direction | Sonraki veri bölgesi kenar hücresinin bulunacağı yön. |
Return
Range
: Veri bölgesi kenar hücresi veya e-tablonun kenarındaki 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 Note()
Belirtilen aralıkla ilişkili notu döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getNote());
Return
String
: Belirli bir hücreyle ilişkili not.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Notes()
Aralıktaki hücrelerle ilişkili notları döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getNotes(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili iki boyutlu bir not 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 Num Columns()
Bu aralıktaki sütun sayısını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); Logger.log(range.getNumColumns());
Return
Integer
: Bu aralıktaki 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 Num Rows()
Bu aralıktaki satır sayısını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); Logger.log(range.getNumRows());
Return
Integer
: Bu aralıktaki 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 Number Format()
Belirtilen aralığın sol üst hücresinin sayı veya tarih biçimini alın. Döndürülen biçim kalıpları E-Tablolar API dokümanlarında açıklanmıştır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('C4'); Logger.log(cell.getNumberFormat());
Return
String
: Aralığın sol üst hücresinin sayı biçimi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Number Formats()
Aralıktaki hücrelerin sayı veya tarih biçimlerini döndürür. Döndürülen biçim kalıpları E-Tablolar API dokümanlarında açıklanmaktadır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B5:C6'); const formats = range.getNumberFormats(); for (const i in formats) { for (const j in formats[i]) { Logger.log(formats[i][j]); } }
Return
String[][]
: İki boyutlu bir sayı biçimleri 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 Rich Text Value()
Aralığın sol üst hücresinin zengin metin değerini veya hücre değeri metin değilse null
değerini döndürür.
// Gets the Rich Text value of cell D4. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('D4:F6'); const richText = range.getRichTextValue(); console.log(richText.getText());
Return
Rich
: Aralığın sol üst hücresinin zengin metin değeridir. Hücre değeri metin değilse null
değerini döndürü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 Rich Text Values()
Aralıktaki hücrelerin zengin metin değerlerini döndürür.
// Gets the Rich Text values for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const values = range.getRichTextValues(); for (let i = 0; i < values.length; i++) { for (let j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
Return
Rich
: Zengin metin değerlerinin iki boyutlu bir 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 Row()
Bu aralığın satır konumunu döndürür. get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2'); Logger.log(range.getRow());
Return
Integer
: Aralığın satır konumu.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Row Index()
Bu aralığın satır konumunu döndürür. get
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2'); Logger.log(range.getRowIndex());
Return
Integer
: Aralığın satır 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
Aşağıdaki kaynakları da incelemenizi öneririz:
get Sheet()
Bu aralığın ait olduğu sayfayı döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
Return
Sheet
: Bu aralığın ait olduğ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
get Text Direction()
Aralıktaki sol üst hücrenin metin yönünü döndürür. Hücre metin yönü otomatik algılama ile belirlenirse null
döndürür.
// Get the text direction of cell B1. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B1:D4'); Logger.log(range.getTextDirection());
Return
Text
: Aralıktaki sol üst hücrenin metin yönü.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Text Directions()
Aralıktaki hücreler için metin yönergelerini döndürür. 2D dizideki girişler, otomatik algılama kullanan hücreler için null
olur.
// Get the text directions for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const directions = range.getTextDirections(); for (let i = 0; i < directions.length; i++) { for (let j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
Return
Text
: İki boyutlu bir metin yönleri 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 Text Rotation()
Aralıktaki sol üst hücrenin metin döndürme ayarlarını döndürür.
// Log the text rotation settings for a cell. const sheet = SpreadsheetApp.getActiveSheet(); const cell = sheet.getRange('A1'); Logger.log(cell.getTextRotation());
Return
Text
: Metin döndürme ayarları.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Text Rotations()
Aralıktaki hücrelerin metin döndürme ayarlarını döndürür.
const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); const results = range.getTextRotations(); for (const i in results) { for (const j in results[i]) { const rotation = results[i][j]; Logger.log('Cell [%s, %s] has text rotation: %v', i, j, rotation); } }
Return
Text
: Aralıktaki hücrelerle ilişkili iki boyutlu bir metin rotasyonu 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 Text Style()
Aralıktaki sol üst hücrenin metin stilini döndürür.
// Get the text style of cell D4. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('D4:F6'); const style = range.getTextStyle(); Logger.log(style);
Return
Text
: Aralıktaki sol üst hücrenin metin stili.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Text Styles()
Aralıktaki hücrelerin metin stillerini döndürür.
// Get the text styles for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const styles = range.getTextStyles(); for (let i = 0; i < styles.length; i++) { for (let j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
Return
Text
: İki boyutlu bir metin stili 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 Value()
Aralıktaki sol üst hücrenin değerini döndürür. Değer, hücrenin değerine bağlı olarak Number
, Boolean
, Date
veya String
türü olabilir. Boş hücreler boş bir dize döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
Return
Object
: Bu hücredeki değerdir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Values()
Bu aralık için dikdörtgen değer ızgarasına döndürür.
Satır ve ardından sütuna göre dizine eklenen iki boyutlu bir değer dizisi döndürür. Değerler, hücrenin değerine bağlı olarak Number
, Boolean
, Date
veya String
türü olabilir. Boş hücreler, dizede boş bir dizeyle temsil edilir. Aralık dizininin 1, 1
ile başladığını, JavaScript dizisinin ise [0][0]
ile dizine eklendiğini unutmayın.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);Web uygulamalarında
Date
değeri geçerli bir parametre değildir. get Values()
, aralık Date
değerine sahip bir hücre içeriyorsa web uygulamasına veri döndüremez. Bunun yerine, sayfadan alınan tüm değerleri Number
, Boolean
veya String
gibi desteklenen bir JavaScript ilkel öğesine dönüştürün.Return
Object[][]
: İki 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 Vertical Alignment()
Aralıktaki sol üst köşedeki hücrenin dikey hizalamasını (üst/orta/alt) döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getVerticalAlignment());
Return
String
: Hücredeki metnin dikey hizalaması.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Vertical Alignments()
Aralıktaki hücrelerin dikey hizalamalarını döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getVerticalAlignments(); for (const i in results) { for (const j in results[i]) { Logger.log(results[i][j]); } }
Return
String[][]
: Aralıktaki hücrelerle ilişkili metinlerin dikey hizalamalarının iki boyutlu 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 Width()
Aralığın sütunlardaki genişliğini döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
Return
Integer
: Aralıktaki 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 Wrap()
Hücredeki metnin sarmalanıp sarmalanmadığını döndürür. Daha ayrıntılı bir sarma stratejisi almak için get
seçeneğini kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.getWrap());
Return
Boolean
: Bu hücredeki metnin kaydırılıp kaydırılmadığını belirtir.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Wrap Strategies()
Aralıktaki hücreler için metin kaydırma stratejilerini döndürür.
// Get the text wrapping strategies for all cells in range B5:C6 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); const strategies = range.getWrapStrategies(); for (let i = 0; i < strategies.length; i++) { for (let j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
Return
Wrap
: Metin sarmalama stratejilerinden oluşan iki boyutlu 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 Wrap Strategy()
Aralıktaki sol üst hücrenin metin kaydırma stratejisini döndürür.
// Get the text wrapping strategy of cell B1. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B1:D4'); Logger.log(range.getWrapStrategy());
Return
Wrap
: Aralıktaki sol üst hücrenin metin kaydırma stratejisi.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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 Wraps()
Hücrelerdeki metnin sarmalanıp sarmalanmadığını döndürür. Daha ayrıntılı bir sarma stratejisi almak için get
seçeneğini kullanın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); const results = range.getVerticalAlignments(); for (const i in results) { for (const j in results[i]) { const isWrapped = results[i][j]; if (isWrapped) { Logger.log('Cell [%s, %s] has wrapped text', i, j); } } }
Return
Boolean[][]
: Aralıktaki hücrelerle ilişkili metinlerin dikey hizalamalarının iki boyutlu 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
insert Cells(shiftDimension)
Bu alana boş hücreler ekler. Yeni hücreler, daha önce bu aralığı kaplayan hücrelerdeki tüm biçimlendirmeleri korur. Sayfada, sağlanan boyut boyunca mevcut veriler eklenen aralıktan kaydırılır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:D10'); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
shift | Dimension | Mevcut verilerin kaydırıldığı boyut. |
Return
Range
: Zincirleme için bu 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
insert Checkboxes()
İşaretli için true
ve işaretsiz için false
ile yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki tüm hücrelerin değerini false
olarak ayarlar.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' // for checked and 'false' for unchecked. Also, sets the value of each cell in // the range A1:B10 to 'false'. range.insertCheckboxes();
Return
Range
: Zincirleme için bu 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
insert Checkboxes(checkedValue)
İşaretli için özel bir değerle ve işaretli olmayan için boş dizeyle yapılandırılmış onay kutularını aralıktaki her hücreye ekler. Aralıktaki her hücrenin değerini boş dize olarak ayarlar.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' // for checked and the empty string for unchecked. Also, sets the value of each // cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checked | Object | Onay kutusu veri doğrulaması için işaretli değer. |
Return
Range
: Zincirleme için bu 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
insert Checkboxes(checkedValue, uncheckedValue)
Aralıktaki her hücreye, işaretli ve işaretli olmayan durumlar için özel değerlerle yapılandırılmış onay kutuları ekler. Aralıktaki her hücrenin değerini, işaretlenmemiş özel değere ayarlar.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' // for checked and 'no' for unchecked. Also, sets the value of each cell in the // range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
checked | Object | Onay kutusu veri doğrulaması için işaretli değer. |
unchecked | Object | Onay kutusu veri doğrulaması için işaretli olmayan değer. |
Return
Range
: Zincirleme için bu 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
is Blank()
Aralık tamamen boşsa true
döndürülür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D4'); Logger.log(range.isBlank());
Return
Boolean
: Aralık boşsa 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 Checked()
Aralıktaki tüm hücrelerin onay kutusu durumunun "işaretli" olup olmadığını döndürür. Bazı hücreler işaretli, geri kalanı işaretsizse veya bazı hücrelerde onay kutusu veri doğrulaması yoksa null
döndürür.
const range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); const range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. const isRange1Checked = range1.isChecked(); const range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked // value. const isRange2Checked = range2.isChecked(); const range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox // value. const isRange3Checked = range3.isChecked();
Return
Boolean
: Aralıktaki tüm hücreler işaretliyse true
, aralıktaki tüm hücreler işaretli değilse false
veya hücrelerden herhangi birinin işareti yoksa ya da onay kutusu veri doğrulaması 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
is End Column Bounded()
Aralığın sonunun belirli bir sütuna bağlı olup olmadığını belirler. Örneğin, A1:B10
veya B:B
aralıkları (aralığın sonundaki sütunlara bağlı) için bu yöntem true
döndürür. 3:7
veya A1:5
aralıkları (aralığın sonundaki belirli satırlara bağlı) için ise bu yöntem false
döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs // it to the console. console.log(range.isEndColumnBounded());
Return
Boolean
: Aralığın sonu belirli bir sütuna bağlıysa 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 End Row Bounded()
Aralığın sonunun belirli bir satıra bağlı olup olmadığını belirler. Örneğin, A1:B10
veya 3:7
aralıkları (aralığın sonundaki satırlarla sınırlı) için bu yöntem true
değerini döndürür. B:B
veya A1:C
aralıkları (aralığın sonundaki belirli sütunlarla sınırlı) için ise false
değerini döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it // to the console. console.log(range.isEndRowBounded());
Return
Boolean
: Aralığın sonu belirli bir satıra bağlıysa true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Part Of Merge()
Geçerli aralıktaki hücreler birleştirilmiş hücrelerle örtüşüyorsa true
değerini döndürür.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:B3'); // True if any of the cells in A1:B3 is included in a merge. const isPartOfMerge = range.isPartOfMerge();
Return
Boolean
: Aralık birleştirilmiş hücrelerle örtüşüyorsa true
, aksi takdirde false
döndürülür.
is Start Column Bounded()
Aralığın başlangıcının belirli bir sütuna bağlı olup olmadığını belirler. Örneğin, aralığın başındaki sütunlara bağlı olan A1:B10
veya B:B
aralıkları için bu yöntem true
değerini döndürür. Aralığın başındaki yalnızca bir satıra bağlı olan 3:7
aralığı için ise bu yöntem false
değerini döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs // it to the console. console.log(range.isStartColumnBounded());
Return
Boolean
: Aralığın başlangıcı belirli bir sütuna bağlıysa true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
is Start Row Bounded()
Aralığın başlangıcının belirli bir satıra bağlı olup olmadığını belirler. Örneğin, aralığın başındaki satırlara bağlı olan A1:B10
veya 3:7
aralıkları için bu yöntem true
değerini döndürür. Aralığın başındaki yalnızca belirli bir sütuna bağlı olan B:B
aralığı için ise bu yöntem false
değerini döndürür.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it // to the console. console.log(range.isStartRowBounded());
Return
Boolean
: Aralığın başlangıcı belirli bir satıra bağlıysa true
, aksi takdirde false
.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
Aralıktaki hücreleri tek bir blok halinde birleştirir.
const sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
Return
Range
: Zincirleme için bu 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
merge Across()
Aralığın sütunlarındaki hücreleri birleştirin.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell const range1 = sheet.getRange('C5:E5'); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 const range2 = sheet.getRange('F5:H6'); range2.mergeAcross();
Return
Range
: Zincirleme için bu 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
merge Vertically()
Aralıktaki hücreleri birleştirir.
const sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
Return
Range
: Zincirleme için bu 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
move To(target)
Bu aralığı (hem biçimi hem de değerleri) kesip hedef alana yapıştırın.
// The code below moves the first 5 columns over to the 6th column const sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange('A1:E').moveTo(sheet.getRange('F1'));
Parametreler
Ad | Tür | Açıklama |
---|---|---|
target | Range | Bu aralığın kopyalanacağı hedef aralık. Yalnızca sol üst hücre konumu önemlidir. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
Bu aralıktan belirli sayıda satır ve sütun (negatif olabilir) uzaklıkta olan yeni bir aralık döndürür. Yeni aralık, orijinal aralıkla aynı boyuttadır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2 const newCell = cell.offset(1, 1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder. |
column | Integer | Aralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder. |
Return
Range
: Zincirleme için bu aralık.
offset(rowOffset, columnOffset, numRows)
Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralıktan belirli satır ve sütunlar kadar uzaktadır ve hücrelerdeki yükseklik de belirlidir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2:B3 const newRange = cell.offset(1, 1, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder. |
column | Integer | Aralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder. |
num | Integer | Yeni aralığın satır sayısı. |
Return
Range
: Zincirleme için bu aralık.
offset(rowOffset, columnOffset, numRows, numColumns)
Geçerli aralığa göre yeni bir aralık döndürür. Bu aralığın sol üst noktası, geçerli aralığından belirli satır ve sütunlar kadar uzaktadır ve hücrelerde belirli bir yükseklik ve genişliğe sahiptir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('A1'); // newCell references B2:C3 const newRange = cell.offset(1, 1, 2, 2);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
row | Integer | Aralığın sol üst hücresinden aşağı doğru satır sayısı; negatif değerler, aralığın sol üst hücresinden yukarı doğru satırları temsil eder. |
column | Integer | Aralığın sol üst hücresinden sağdaki sütunların sayısı; negatif değerler, aralığın sol üst hücresinden soldaki sütunları temsil eder. |
num | Integer | Yeni aralığın satır sayısı. |
num | Integer | Yeni aralığın sütun genişliği. |
Return
Range
: Zincirleme için bu aralık.
protect()
İzin sahibi kullanıcılar dışındaki kullanıcıların düzenlemesini engelleyebilecek bir nesne oluşturur. Komut dosyası, aralığın düzenleyici listesini gerçekten değiştirene (Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
çağrısı yaparak veya Protection.setDomainEdit(editable)
için yeni bir değer ayarlayarak) kadar izinler e-tablonun izinlerini yansıtır. Bu da aralığın korumasız kalması anlamına gelir. Aralık zaten korunuyorsa bu yöntem, mevcut aralıkla çakışan yeni bir korumalı aralık oluşturur. Bir hücre birden fazla korumalı aralık tarafından korunuyorsa ve bunlardan herhangi biri belirli bir kullanıcının hücreyi düzenlemesini engelliyorsa söz konusu kullanıcının hücreyi düzenlemesine izin verilmez.
// Protect range A1:B10, then remove all other users from the list of editors. const ss = SpreadsheetApp.getActive(); const range = ss.getRange('A1:B10'); const protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if // the user's edit permission comes from a group, the script throws an exception // upon removing the group. const me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Return
Protection
: Koruma ayarlarını temsil eden bir nesne.
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
Belirtilen aralıktaki satırların sırasını rastgele hale getirir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:C7'); // Randomizes the range range.randomize();
Return
Range
: Zincirleme için bu 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
remove Checkboxes()
Aralıktaki tüm onay kutularını kaldırır. Her hücrenin veri doğrulamasını temizler ve hücre işaretli veya işaretsiz bir değer içeriyorsa değerini de temizler.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); const range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); const range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
Return
Range
: Zincirleme için bu 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
remove Duplicates()
Bu aralıktaki, önceki bir satırdaki değerlerin yinelemesi olan değerleri içeren satırları kaldırır. Aynı değerlere sahip ancak büyük/küçük harf kullanımı, biçimlendirme veya formül farklılığı olan satırlar yinelenen olarak kabul edilir. Bu yöntem, görünümden gizlenen (ör. bir filtre nedeniyle) yinelenen satırları da kaldırır. Bu aralığın dışındaki içerikler kaldırılmaz.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B1:D7'); // Remove duplicate rows in the range. range.removeDuplicates();
Return
Range
: Yinelenenler kaldırıldıktan sonra elde edilen aralık. Kaldırılan her satır için aralık boyutu bir satır azalı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
remove Duplicates(columnsToCompare)
Belirtilen sütunlarda önceki bir satırdaki değerlerin yinelemesini içeren, bu aralıktaki satırları kaldırır. Aynı değerlere sahip ancak büyük/küçük harf kullanımı, biçimlendirme veya formül farklılığı olan satırlar yinelenen olarak kabul edilir. Bu yöntem, görünümden gizlenen yinelenen satırları da (ör. bir filtre nedeniyle) kaldırır. Bu aralığın dışındaki içerikler kaldırılmaz.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B1:D7'); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2, 4]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
columns | Integer[] | Yinelenen değerler için analiz edilecek sütunlar. Sütun belirtilmezse tüm sütunlar yinelenenler açısından analiz edilir. |
Return
Range
: Yinelenenler kaldırıldıktan sonra elde edilen aralık. Kaldırılan her satır için aralık boyutu bir satır azalı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 Background(color)
CSS notasyonunda ('#ffffff'
veya 'white'
gibi) aralıktaki tüm hücrelerin arka plan rengini ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('B2:D5'); range.setBackground('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS notasyonunda bir renk kodu ('#ffffff' veya 'white' gibi); null değeri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Background Object(color)
Aralıktaki tüm hücrelerin arka plan rengini ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const range = sheet.getRange('B2:D5'); range.setBackgroundObject(bgColor);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak arka plan rengi; null değeri arka plan rengini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Background Objects(color)
Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); const colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4], ]; const cell = sheet.getRange('B5:C6'); cell.setBackgroundObjects(colors);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | Color[][] | İki boyutlu bir renk dizisidir. null değerleri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Background RGB(red, green, blue)
RGB değerlerini (0 ile 255 dahili tam sayılar) kullanarak arka planı belirtilen renge ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
red | Integer | RGB gösterimindeki kırmızı değer. |
green | Integer | RGB gösterimindeki yeşil değer. |
blue | Integer | RGB gösterimindeki mavi değer. |
Return
Range
: Zincirleme için bu 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 Backgrounds(color)
Dikdörtgen bir arka plan rengi ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler CSS notasyonundadır (ör. '#ffffff'
veya 'white'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colors = [ ['red', 'white', 'blue'], ['#FF0000', '#FFFFFF', '#0000FF'], // These are the hex equivalents ]; const cell = sheet.getRange('B5:D6'); cell.setBackgrounds(colors);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String[][] | CSS notasyonunda iki boyutlu bir renk dizisi ('#ffffff' veya 'white' gibi); null değerleri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Border(top, left, bottom, right, vertical, horizontal)
Kenarlık özelliğini ayarlar. Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) şeklindedir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | Dahili dikey kenarlıklar için true , hiç kenarlık yok için false , değişiklik yok için null . |
horizontal | Boolean | Dahili yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
Return
Range
: Zincirleme için bu 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 Border(top, left, bottom, right, vertical, horizontal, color, style)
Kenarlık özelliğini renk ve/veya stil ile ayarlar. Geçerli değerler true
(açık), false
(kapalı) ve null
(değişiklik yok) şeklindedir. Renk için CSS notasyonunda renk kullanın (ör. '#ffffff'
veya 'white'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder( true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED, );
Parametreler
Ad | Tür | Açıklama |
---|---|---|
top | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
left | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
bottom | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
right | Boolean | Kenarlık için true , yok için false , değişiklik yok için null . |
vertical | Boolean | Dahili dikey kenarlıklar için true , hiç kenarlık yok için false , değişiklik yok için null . |
horizontal | Boolean | Dahili yatay kenarlıklar için true , hiçbiri için false , değişiklik yok için null . |
color | String | CSS notasyonunda bir renk ('#ffffff' veya 'white' gibi), varsayılan renk için null (siyah). |
style | Border | Kenarlıklar için bir stil. Varsayılan stil (döşeli) için null . |
Return
Range
: Zincirleme için bu 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 Data Validation(rule)
Aralıktaki tüm hücreler için bir veri doğrulama kuralı belirler.
// Set the data validation rule for cell A1 to require a value from B1:B10. const cell = SpreadsheetApp.getActive().getRange('A1'); const range = SpreadsheetApp.getActive().getRange('B1:B10'); const rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rule | Data | Ayarlanacak veri doğrulama kuralı veya veri doğrulamayı kaldırmak için null . |
Return
Range
: Zincirleme için bu 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 Data Validations(rules)
Aralıktaki tüm hücreler için veri doğrulama kurallarını ayarlar. Bu yöntem, satır ve sütuna göre dizine eklenen iki boyutlu bir veri doğrulama dizisi alır. Dizi boyutları, aralık boyutlarıyla eşleşmelidir.
// Set the data validation rules for Sheet1!A1:B5 to require a value from // Sheet2!A1:A10. const destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); const sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); const rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); const rules = destinationRange.getDataValidations(); for (let i = 0; i < rules.length; i++) { for (let j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rules | Data | Ayarlanacak iki boyutlu veri doğrulama kuralı dizisi; null değerleri veri doğrulamayı kaldırır. |
Return
Range
: Zincirleme için bu 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 Font Color(color)
Yazı tipi rengini CSS notasyonunda ('#ffffff'
veya 'white'
gibi) ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontColor('red');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | String | CSS gösterimindeki yazı tipi rengi (ör. '#ffffff' veya 'white' ); null değeri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Color Object(color)
Belirtilen aralığın yazı tipi rengini ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const cell = sheet.getRange('B2'); cell.setFontColor(color);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
color | Color | Ayarlanacak yazı tipi rengi. null değeri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Color Objects(colors)
Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); const colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4], ]; const cell = sheet.getRange('B5:C6'); cell.setFontColorObjects(colors);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
colors | Color[][] | İki boyutlu bir renk dizisidir. null değerleri yazı tipi rengini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Colors(colors)
Yazı tipi renklerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Renkler CSS notasyonundadır (ör. '#ffffff'
veya 'white'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const colors = [ ['red', 'white', 'blue'], ['#FF0000', '#FFFFFF', '#0000FF'], // These are the hex equivalents ]; const cell = sheet.getRange('B5:D6'); cell.setFontColors(colors);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
colors | Object[][] | CSS notasyonunda iki boyutlu bir renk dizisi ('#ffffff' veya 'white' gibi); null değerleri rengi sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Families(fontFamilies)
Yazı tipi ailelerinden dikdörtgen bir ızgara oluşturur (bu aralığın boyutlarıyla eşleşmelidir). "Arial" veya "Helvetica", yazı tipi ailesine örnek olarak verilebilir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const fonts = [ ['Arial', 'Helvetica', 'Verdana'], ['Courier New', 'Arial', 'Helvetica'], ]; const cell = sheet.getRange('B2:D3'); cell.setFontFamilies(fonts);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | Object[][] | İki boyutlu bir yazı tipi ailesi dizisi; null değerleri yazı tipi ailesini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Family(fontFamily)
"Arial" veya "Helvetica" gibi yazı tipi ailesini ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontFamily('Helvetica');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Ayarlanacak yazı tipi ailesi. null değeri yazı tipi ailesini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Line(fontLine)
Belirtilen aralığın yazı tipi çizgi stilini ('underline'
, 'line-through'
veya 'none'
) belirler.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontLine('line-through');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi satır stili ('underline' , 'line-through' veya 'none' ). null değeri yazı tipi satır stilini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Lines(fontLines)
Dikdörtgen bir çizgi stili ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontLines = [['underline', 'line-through', 'none']]; const range = sheet.getRange('B2:D2'); range.setFontLines(fontLines);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | Object[][] | Yazı tipi çizgi stillerinden oluşan iki boyutlu bir dizi ('underline' , 'line-through' veya 'none' ); null değerleri yazı tipi çizgi stilini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Size(size)
Yazı tipi boyutunu belirler. Boyut, kullanılacak punto boyutudur.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontSize(20);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
size | Integer | Punto boyutunda bir yazı tipi boyutu. |
Return
Range
: Zincirleme için bu 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 Font Sizes(sizes)
Yazı tipi boyutlarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Boyutlar nokta cinsindendir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontSizes = [[16, 20, 24]]; const range = sheet.getRange('B2:D2'); range.setFontSizes(fontSizes);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sizes | Object[][] | İki boyutlu bir boyut dizisi. |
Return
Range
: Zincirleme için bu 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 Font Style(fontStyle)
Belirtilen aralık için yazı tipi stilini ayarlayın ('italic'
veya 'normal'
).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontStyle('italic');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi stili ('italic' veya 'normal' ); null değeri yazı tipi stilini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Styles(fontStyles)
Yazı tipi stillerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontStyles = [['italic', 'normal']]; const range = sheet.getRange('B2:C2'); range.setFontStyles(fontStyles);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | Object[][] | 'italic' veya 'normal' olan iki boyutlu bir yazı tipi stili dizisi; null değerleri yazı tipi stilini sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Weight(fontWeight)
Belirtilen aralık için yazı tipi ağırlığını (normal/kalın) ayarlayın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setFontWeight('bold');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | String | Yazı tipi kalınlığı ('bold' veya 'normal' ); null değeri yazı tipi kalınlığını sıfırlar. |
Return
Range
: Zincirleme için bu 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 Font Weights(fontWeights)
Yazı tipi kalınlıklarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Yazı tipi kalınlığı örneği "bold"dur.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const fontStyles = [['bold', 'bold', 'normal']]; const range = sheet.getRange('B2:D2'); range.setFontWeights(fontStyles);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
font | Object[][] | 'bold' veya 'normal' olan iki boyutlu bir yazı tipi ağırlığı dizisi; null değerleri yazı tipi ağırlığını sıfırlar. |
Return
Range
: Zincirleme için bu 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 Formula(formula)
Bu aralıktaki formülü günceller. Belirtilen formül A1 gösterimde olmalıdır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); cell.setFormula('=SUM(B3:B4)');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Hücre için ayarlanacak formülü temsil eden bir dize. |
Return
Range
: Zincirleme için bu 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 Formula R1C1(formula)
Bu aralıktaki formülü günceller. Belirtilen formül R1C1 gösterimde olmalıdır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B5'); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formula | String | Bir dize formülü. |
Return
Range
: Zincirleme için bu 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 Formulas(formulas)
Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller A1 gösterimde olmalıdır. Bu yöntem, satır ve ardından sütuna göre dizine eklenen iki boyutlu bir formül dizisi alır. Dizi boyutları, aralık boyutlarıyla eşleşmelidir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages // right below. The size of the two-dimensional array must match the size of the // range. const formulas = [ ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'], ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'], ]; const cell = sheet.getRange('B5:D6'); cell.setFormulas(formulas);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formulas | String[][] | Formüllerden oluşan iki boyutlu dize dizisi. |
Return
Range
: Zincirleme için bu 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 Formulas R1C1(formulas)
Dikdörtgen bir formül ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Verilen formüller R1C1 gösterimde olmalıdır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. const sumOfRowsAbove = '=SUM(R[-3]C[0]:R[-1]C[0])'; const averageOfRowsAbove = '=AVERAGE(R[-4]C[0]:R[-2]C[0])'; // The size of the two-dimensional array must match the size of the range. const formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove], ]; const cell = sheet.getRange('B5:D6'); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
formulas | String[][] | R1C1 biçiminde iki boyutlu bir formül dizisi. |
Return
Range
: Zincirleme için bu 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 Horizontal Alignment(alignment)
Belirtilen aralık için yatay (soldan sağa) hizalamayı (sol/orta/sağ) ayarlayın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setHorizontalAlignment('center');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('left' , 'center' veya 'normal' ); null değeri hizalamayı sıfırlar. |
Return
Range
: Zincirleme için bu 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 Horizontal Alignments(alignments)
Yatay hizalamalarla dikdörtgen bir ızgara ayarlar. set
bölümüne bakın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const horizontalAlignments = [['left', 'right', 'center']]; const range = sheet.getRange('B2:D2'); range.setHorizontalAlignments(horizontalAlignments);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignments | Object[][] | 'left' , 'center' veya 'normal' olan iki boyutlu bir hizalama dizisi; null değeri, hizalamayı sıfırlar. |
Return
Range
: Zincirleme için bu 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:
set Note(note)
Notu belirtilen değere ayarlar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setNote('This is a note');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
note | String | Aralık için ayarlanacak not değeri. null değeri notu kaldırır. |
Return
Range
: Zincirleme için bu 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 Notes(notes)
Dikdörtgen bir not ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const notes = [ ['it goes', 'like this', 'the fourth, the fifth'], ['the minor fall', 'and the', 'major lift'], ]; const cell = sheet.getRange('B2:D3'); cell.setNotes(notes);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
notes | Object[][] | İki boyutlu bir not dizisidir. null değerleri notu kaldırır. |
Return
Range
: Zincirleme için bu 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:
set Number Format(numberFormat)
Sayı veya tarih biçimini belirtilen biçimlendirme dizesine ayarlar. Kabul edilen biçim kalıpları E-Tablolar API dokümanlarında açıklanmaktadır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); // Always show 3 decimal points cell.setNumberFormat('0.000');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | String | Sayı biçimi dizesi. |
Return
Range
: Zincirleme için bu 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 Number Formats(numberFormats)
Sayı veya tarih biçimlerinden oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Değerler, E-Tablolar API dokümanlarında açıklandığı gibi biçim kalıbı dizeleridir.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const formats = [['0.000', '0,000,000', '$0.00']]; const range = sheet.getRange('B2:D2'); range.setNumberFormats(formats);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
number | Object[][] | İki boyutlu bir sayı biçimleri dizisi. |
Return
Range
: Zincirleme için bu 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 Rich Text Value(value)
Aralıktaki hücreler için zengin metin değerini ayarlar.
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" // bolded. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const richText = SpreadsheetApp.newRichTextValue() .setText('Hello world') .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | Rich | İstediğiniz zengin metin değeri. |
Return
Range
: Zincirleme için bu 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 Rich Text Values(values)
Zengin metin değerlerinin dikdörtgen bir ızgarasına ayarlanır.
// Sets the cells in range A1:A2 to have Rich Text values. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:A2'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const italic = SpreadsheetApp.newTextStyle().setItalic(true).build(); const richTextA1 = SpreadsheetApp.newRichTextValue() .setText('This cell is bold') .setTextStyle(bold) .build(); const richTextA2 = SpreadsheetApp.newRichTextValue() .setText('bold words, italic words') .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | Rich | İstediğiniz zengin metin değerleri. |
Return
Range
: Zincirleme için bu 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 Show Hyperlink(showHyperlink)
Aralığın köprüleri gösterip göstermeyeceğini belirler.
// Opens the spreadsheet file by its URL. If you created your script from within // a Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() // instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl( 'https://docs.google.com/spreadsheets/d/abc123456/edit', ); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
show | Boolean | Köprünün gösterilip gösterilmeyeceği. |
Return
Range
: Zincirleme için bu 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 Text Direction(direction)
Aralıktaki hücrelerin metin yönünü belirler. Belirtilen yön null
ise yön tahmin edilir ve ayarlanır.
// Sets right-to-left text direction for the range. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B5:C6'); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
direction | Text | İstenen metin yönü; null ise yön ayarlanmadan önce anlaşılır. |
Return
Range
: Zincirleme için bu 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 Text Directions(directions)
Metin yönlerinden oluşan dikdörtgen bir ızgara ayarlar. Belirtilen yön null
ise yön tahmin edilir ve ayarlanır.
// Copies all of the text directions from range A1:B2 over to range C5:D6. const sheet = SpreadsheetApp.getActiveSheet(); const range1 = sheet.getRange('A1:B2'); const range2 = sheet.getRange('C5:D6'); range2.setTextRotations(range1.getTextDirections());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
directions | Text | İstenen metin yönleri; belirtilen bir yön null ise ayardan önce anlaşılır. |
Return
Range
: Zincirleme için bu 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 Text Rotation(degrees)
Aralıktaki hücreler için metin döndürme ayarlarını belirler. Giriş, standart metin yönü ile istenen yön arasındaki açıya karşılık gelir. Sıfır girişi, metnin standart yönde ayarlandığını gösterir.
Soldan sağa metin yönü için pozitif açılar saat yönünün tersine, sağdan sola metin yönü için ise saat yönündedir.
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); range.setTextRotation(45);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
degrees | Integer | Standart yön ile istenen yön arasındaki açı. Soldan sağa metinlerde pozitif açılar saat yönünün tersine doğrudur. |
Return
Range
: Zincirleme için bu 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 Text Rotation(rotation)
Aralıktaki hücreler için metin döndürme ayarlarını belirler.
// Sets all cell's in range B2:D4 to have the same text rotation settings as // cell A1. const sheet = SpreadsheetApp.getActiveSheet(); const rotation = sheet.getRange('A1').getTextRotation(); sheet.getRange('B2:D4').setTextRotation(rotation);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rotation | Text | İstediğiniz metin döndürme ayarları. |
Return
Range
: Zincirleme için bu 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 Text Rotations(rotations)
Metin rotasyonlarından oluşan dikdörtgen bir ızgara ayarlar.
// Copies all of the text rotations from range A1:B2 over to range C5:D6. const sheet = SpreadsheetApp.getActiveSheet(); const range1 = sheet.getRange('A1:B2'); const range2 = sheet.getRange('C5:D6'); range2.setTextRotations(range1.getTextRotations());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
rotations | Text | İstediğiniz metin döndürme ayarları. |
Return
Range
: Zincirleme için bu 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 Text Style(style)
Aralıktaki hücrelerin metin stilini ayarlar.
// Sets the cells in range C5:D6 to have underlined size 15 font. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('C5:D6'); const style = SpreadsheetApp.newTextStyle().setFontSize(15).setUnderline(true).build(); range.setTextStyle(style);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
style | Text | İstediğiniz metin stili. |
Return
Range
: Zincirleme için bu 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 Text Styles(styles)
Metin stillerinden oluşan dikdörtgen bir ızgara oluşturur.
// Sets text styles for cells in range A1:B2 const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B2'); const bold = SpreadsheetApp.newTextStyle().setBold(true).build(); const otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor('#335522') .setFontSize(44) .build(); range.setTextStyles([ [bold, otherStyle], [otherStyle, bold], ]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
styles | Text | İstediğiniz metin stilleri. |
Return
Range
: Zincirleme için bu 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 Value(value)
Aralığın değerini ayarlar. Değer sayı, dize, boole veya tarih olabilir. '='
ile başlarsa formül olarak yorumlanır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setValue(100);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
value | Object | Aralığın değeri. |
Return
Range
: Zincirleme için bu 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 Values(values)
Dikdörtgen bir değer ızgarası ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Bir değer =
ile başlıyorsa formül olarak yorumlanır.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const values = [['2.000', '1,000,000', '$2.99']]; const range = sheet.getRange('B2:D2'); range.setValues(values);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
values | Object[][] | İki boyutlu bir değer dizisi. |
Return
Range
: Zincirleme için bu 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 Vertical Alignment(alignment)
Belirtilen aralık için dikey (üstten alta) hizalamayı (üst/orta/alt) ayarlayın.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setVerticalAlignment('middle');
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignment | String | Hizalama ('top' , 'middle' veya 'bottom' ); null değeri hizalamayı sıfırlar. |
Return
Range
: Zincirleme için bu 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 Vertical Alignments(alignments)
Dikey hizalamalarla dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir).
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const alignments = [['top', 'middle', 'bottom']]; const range = sheet.getRange('B2:D2'); range.setVerticalAlignments(alignments);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
alignments | Object[][] | 'top' , 'middle' veya 'bottom' değerini alan iki boyutlu bir hizalama dizisi; null değeri, hizalamayı sıfırlar. |
Return
Range
: Zincirleme için bu 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:
set Vertical Text(isVertical)
Aralıktaki hücrelerin metninin yığın halinde gösterilip gösterilmeyeceğini belirler. Metin dikey olarak yığılmışsa metin döndürme derecesi ayarı yoksayılır.
// Sets all cell's in range B2:D4 to have vertically stacked text. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); range.setVerticalText(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Boolean | Metnin yığılıp yığılmayacağı. |
Return
Range
: Zincirleme için bu 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 Wrap(isWrapEnabled)
Belirtilen aralığın hücre sarma özelliğini ayarlayın.
Kaydırma özelliği etkin olan hücreler (varsayılan), içeriğin tamamını gösterecek şekilde yeniden boyutlandırılır. Satır sonuna sığdırma özelliği devre dışı bırakılmış hücreler, yeniden boyutlandırılmadan veya birden fazla satıra yayılmadan hücrede mümkün olduğunca fazla yer kaplar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const cell = sheet.getRange('B2'); cell.setWrap(true);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Boolean | Metnin kaydırılıp kaydırılmayacağı. |
Return
Range
: Zincirleme için bu 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 Wrap Strategies(strategies)
Dikdörtgen bir sarma stratejisi ızgarası ayarlar.
// Copies all of the wrap strategies from range A1:B2 over to range C5:D6. const sheet = SpreadsheetApp.getActiveSheet(); const range1 = sheet.getRange('A1:B2'); const range2 = sheet.getRange('C5:D6'); range2.setWrapStrategies(range1.getWrapStrategies());
Parametreler
Ad | Tür | Açıklama |
---|---|---|
strategies | Wrap | İstenen sarma stratejileri. |
Return
Range
: Zincirleme için bu 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 Wrap Strategy(strategy)
Aralıktaki hücreler için metin kaydırma stratejisini belirler.
// Sets all cells in range B2:D4 to use the clip wrap strategy. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('B2:D4'); range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
strategy | Wrap | İstenen sarma stratejisi. |
Return
Range
: Zincirleme için bu 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 Wraps(isWrapEnabled)
Satır sonu politikalarından oluşan dikdörtgen bir ızgara ayarlar (bu aralığın boyutlarıyla eşleşmelidir). Kaydırma özelliği etkinleştirilmiş hücreler (varsayılan ayar), içeriğin tamamını gösterecek şekilde yeniden boyutlandırılır. Satır sonuna sarma özelliği devre dışı bırakılmış hücreler, yeniden boyutlandırılmadan veya birden fazla satıra yayılmadan hücrede mümkün olduğunca fazla yer kaplar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. const wraps = [[true, true, false]]; const range = sheet.getRange('B2:D2'); range.setWraps(wraps);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
is | Object[][] | Metnin bir hücreye sığıp sığmayacağını belirleyen iki boyutlu bir kaydırma değişkeni dizisi. |
Return
Range
: Zincirleme için bu 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:
shift Column Group Depth(delta)
Aralığın sütun gruplandırma derinliğini belirtilen miktar kadar değiştirir.
Bu işlem, aralıkla kesişen gruplar oluşturma, değiştirme veya silme etkisine sahiptir. Pozitif deltalarda gruplar oluşturulur ve/veya değiştirilir. Negatif deltalarda ise gruplar silinir ve/veya değiştirilir.
Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durum herhangi bir etki yaratmaz.
column group control position
BEFORE
ise ilk satırın derinliği değiştirilmeye çalışılırken hata oluşur.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // The column grouping depth is increased by 1. range.shiftColumnGroupDepth(1); // The column grouping depth is decreased by 1. range.shiftColumnGroupDepth(-1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
delta | Integer | Bu aralığın sütun grubu derinliğinin değiştirileceği miktar. |
Return
Range
: Zincirleme için bu aralık.
Atışlar
Error
: Kontrol konumu Group
olduğunda ilk sütunun derinliğini değiştirmeye çalışırken
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shift Row Group Depth(delta)
Aralığın satır gruplandırma derinliğini belirtilen miktarda değiştirir.
Bu işlem, aralıkla kesişen gruplar oluşturma, değiştirme veya silme etkisine sahiptir. Pozitif deltalarda gruplar oluşturulur ve/veya değiştirilir. Negatif deltalarda ise gruplar silinir ve/veya değiştirilir.
Grup derinliği sıfırın altına veya sekizin üzerine düşürüldüğünde bu durum herhangi bir etki yaratmaz.
row group control position
BEFORE
ise ilk satırın derinliği değiştirilmeye çalışılırken hata oluşur.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getActiveRange(); // The row grouping depth is increased by 1. range.shiftRowGroupDepth(1); // The row grouping depth is decreased by 1. range.shiftRowGroupDepth(-1);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
delta | Integer | Bu aralığın satır grubu derinliğinin değiştirileceği miktar. |
Return
Range
: Zincirleme için bu aralık.
Atışlar
Error
: Kontrol konumu Group
olduğunda ilk satırın derinliğini değiştirmeye çalışırken
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aş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(sortSpecObj)
Belirtilen aralıktaki hücreleri, sütuna ve belirtilen sıraya göre sıralar.
const ss = SpreadsheetApp.getActiveSpreadsheet(); const sheet = ss.getSheets()[0]; const range = sheet.getRange('A1:C7'); // Sorts by the values in the first column (A) range.sort(1); // Sorts by the values in the second column (B) range.sort(2); // Sorts descending by column B range.sort({column: 2, ascending: false}); // Sorts descending by column B, then ascending by column A // Note the use of an array range.sort([ {column: 2, ascending: false}, {column: 1, ascending: true}, ]); // For rows that are sorted in ascending order, the "ascending" parameter is // optional, and just an integer with the column can be used instead. Note that // in general, keeping the sort specification consistent results in more // readable code. You can express the earlier sort as: range.sort([{column: 2, ascending: false}, 1]); // Alternatively, if you want all columns to be in ascending order, you can use // the following (this makes column 2 ascending) range.sort([2, 1]); // ... which is equivalent to range.sort([ {column: 2, ascending: true}, {column: 1, ascending: true}, ]);
Parametreler
Ad | Tür | Açıklama |
---|---|---|
sort | Object | Sıralama ölçütü olarak kullanılacak sütunlar. |
Return
Range
: Zincirleme için bu 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
split Text To Columns()
Otomatik olarak algılanan bir sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.
// A1:A3 has the following values: // A B C // 1 |one,one,one | | | // 2 |two,two,two | | | // 3 |three,three,three| | | const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3'); range.splitTextToColumns(); // Result after splitting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
split Text To Columns(delimiter)
Belirtilen dizeyi özel ayırıcı olarak kullanarak bir metin sütununu birden çok sütuna böler.
// A1:A3 has the following values: // A B C // 1 |one#one#one | | | // 2 |two#two#two | | | // 3 |three#three#three| | | const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3'); range.splitTextToColumns('#'); // Result after splitting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parametreler
Ad | Tür | Açıklama |
---|---|---|
delimiter | String | Bölünecek özel ayırıcı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
split Text To Columns(delimiter)
Belirtilen sınırlayıcıya göre bir metin sütununu birden çok sütuna böler.
// A1:A3 has the following values: // A B C // 1 |one;one;one | | | // 2 |two;two;two | | | // 3 |three;three;three| | | const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3'); range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON); // Result after splitting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parametreler
Ad | Tür | Açıklama |
---|---|---|
delimiter | Text | Bölünecek hazır sınırlayıcı. |
Yetkilendirme
Bu yöntemi kullanan komut dosyalarının aşağıdaki kapsamlardan bir veya daha fazlası için yetkilendirilmesi gerekir:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trim Whitespace()
Bu aralıktaki her hücredeki boşlukları (boşluklar, sekmeler veya yeni satırlar gibi) kırpar. Her hücrenin metninin başındaki ve sonundaki tüm boşlukları kaldırır ve kalan boşluk karakterlerinin alt dizelerini tek bir boşluk karakterine indirger.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:A4'); range.activate(); range.setValues([ ' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)', ]); range.trimWhitespace(); const values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', // '=SUM(1,2)']
Return
Range
: Zincirleme için bu 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
uncheck()
Aralıktaki onay kutularının durumunu "işaretli değil" olarak değiştirir. Aralıktaki, şu anda yapılandırılmış işaretli veya işaretli olmayan değeri içermeyen hücreler yoksayılır.
// Changes the state of cells which currently contain either the checked or // unchecked value configured in the range A1:B10 to 'unchecked'. const range = SpreadsheetApp.getActive().getRange('A1:B10'); range.uncheck();
Return
Range
: Zincirleme için bu 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