Bir Google E-Tablolar Komut Dosyası Başlangıç ​​Kılavuzu

Nasıl

TarafındanRyan Dube

Son Güncelleme Tarihi:6 Ağustos 2020

Google E-Tablolar'ı kullanırsanız, Google Script'lerin e-tablolarınızı büyük ölçüde artırabileceğini bilmek isteyebilirsiniz.

Google Scriptleri şöyle düşünün Microsoft Excel'de VBA. Veri girişini otomatikleştirmek için e-tablonuza kod eklemenizi sağlar. Harici verileri sayfalarınıza getirmek için de kullanabilirsiniz. En iyisi, hesaplamaları e-tablonuz açık olmasa bile periyodik bir programda çalıştırabilirsiniz.

Bu makalede, Google Komut Dosyalarını nasıl etkinleştireceğinizi ve basit bir komut dosyasının nasıl yazılacağını ve çalıştırılacağını öğreneceksiniz.

Google Komut Dosyalarını Kullanma

Google E-Tablolar'da, orada Google Scripts yazmaya başlayabilmeniz için etkinleştirmeniz gereken birkaç şey vardır.

Araçlar menüsünü ve ardından Komut dosyası düzenleyici seçin.

Bu, Google Scripts düzenleyicisini bir Adsız proje penceresinde açar.

Bu komut dosyası aslında Google Komut Dosyaları aracındaki Google hesabınızda bulunur. Bu belirli proje üzerinde çalışmakta olduğunuz e-tabloya bağlı.

Bir komut dosyası yazabilirsiniz ancak komut dosyaları sayfada gerçekten etkinleştirilene kadar çalıştıramazsınız. Bunu ilk kez çalıştırdığınızda yapmanız gerekir (aşağıda göreceğiniz gibi).

Bunu çalışırken görmek için basit bir komut dosyası yapalım.

İlk Google Komut Dosyanızı Oluşturun

Bu örnekte, B sütunu için tüm sınav ve final sınav puanlarını toplayan bir senaryo yazacaksınız (Chris’in puanları).

Bu örnek e-tablodur.

Google Scripts penceresine geri döndüğümde, aşağıdaki kodu myFunction () küme parantezleri fonksiyonunun içine yapıştırın:


işlev myFunction () {
var ss = SpreadsheetApp.getActiveSpreadsheet ();
var sayfa = ss.getSheets () [0] var range = sheet.getRange (2,2,5);
var değerleri = range.getValues ​​();
var sum = 0
for (değerlerde var satır) {
for (değerlerde var col [satır]) {
sum = değerler [satır] [col] + toplam;
}
}
sheet.getRange (7,2) .setValue (toplam);
}


Bu kod karmaşık görünebilir, ancak yaptıklarını tam olarak çözelim. Göründüğünden daha basit.

Bu kodu her seferinde bir satır aşağı kıralım.

Değişkenleri Tanımlama

1. var ss = SpreadsheetApp.getActiveSpreadsheet ();

Bu satır, etkin olan geçerli e-tabloyu alır. Bu komut dosyasını yalnızca hesaplamayı çalıştırmak istediğiniz e-tablo etkinken çalıştırdığınız için, her zaman doğru e-tabloyu alır. Sayfa, “ss” adı verilen bir “nesne” değişkeni olarak kaydedilir.

2. var sayfa = ss.getSheets () [0]

Bu, ilk sayfayı alır ve sayfa adlı bir nesne değişkeni olarak kaydeder. Sayfayı sayfa adına göre almak için kullanabileceğiniz alternatif bir işlev var.

Olurdu var sayfa = ss.getSheetByName (“Sayfa1”);

İstediğiniz iki işlevi de kullanabilirsiniz.

3. var range = sheet.getRange (2,2,5);

Bu işlev, satır, sütun ve satır sayısına göre bir değer aralığı alır. Bu durumda, ikinci satırdan, ikinci sütundan başlayarak ve değerleri beş satır aşağı çekerek tüm değerleri alıyoruz.

"Aralık" değişkeni, "dizi" olarak bilinen şeye dönüşür. Dizi, birden çok değer içeren bir değişkendir. Google Script'te, aşağıda göreceğiniz gibi, parantez içeren özel bir öğe adresleme şeması kullanarak bu numaralardan herhangi birine başvurursunuz.

4. var değerleri = range.getValues ​​();

GetValues ​​() işlevi aslında değerleri yukarıda tanımladığınız aralık nesnesinden alır.

5. var sum = 0

Bu yalnızca 0 rakamıyla başlattığımız tek bir sayı değişkeni. Bu, sütundaki tüm sayıları nasıl toplayacağımızın başlangıcı olur.

Döngüler İçin Oluşturma

6. for (değerlerde var satır) {

Buna “For” döngüsü denir. Bu tür döngü, listedeki belirli sayıda öğeye adım atar. Bu durumda, yukarıda tartıştığımız “değerler” dizisinden geçecektir. Bu ilk döngü dizideki tüm satırlar arasında döngü yapar. Bu durumda sadece bir tane olacak.

Not: dizi satırları, e-tablo satırlarıyla aynı değildir. Dizi, e-tablodaki sütundaki değerleri yüklediğinde, bunları şu şekilde tek bir veri satırına (veya satırına) koyar: “89, 92, 78, 98, 89”. Bu durumda, dizinin bir satırı (satırı) ve beş sayısı (sütunları) vardır.

7. for (değerlerde var col [satır]) {

Döngü için bu saniye dizideki tüm “satırlardan” geçer. Bu durumda, 5 değerin tümü arasında geçiş yapar.

8. sum = değerler [satır] [col] + toplam;

Döngü her çalıştığında, bu ifade yeni değerin toplamını kendine toplar. 5 döngünün tümü gerçekleştiğinde, 5 sayının tamamı “toplam” değişkenine toplanmalıdır.

9 sheet.getRange (7,2) .setValue (toplam);

Bu iki işlevli bir ifadedir. GetRange işlevi 7. satır ve 2. sütundaki hücreyi gösterir. SetValue işlevi daha sonra "sum" değişkeninin değerini bu hücreye yerleştirir.

Artık kodun her bir satırının nasıl çalıştığını anladığınıza göre, her şeyi çalışırken görmenin zamanı geldi.

Google Komut Dosyanızı Kaydetme

Google betiğinizi yazmayı bitirdikten sonra, kaydetme ve kodda ilerlemenin zamanı geldi. İlk olarak, projenize bir ad vermek için “Adsız proje” yazın. Ardından, komut dosyasını kaydetmek için menüdeki disket simgesini seçin.

Kaydetmeye çalıştığınızda bir hata görebilirsiniz. Panik yapma. Bu aslında hata ayıklama işleminin bir parçasıdır. Bir hatanız olduğunu söylediği satır numarasına dikkat edin. Kodunuza yakından bakın ve sahip olabileceğiniz yazım hataları veya sözdizimi hatalarını çözün.

Bu örnekte, 8. satırdaki “for” döngümde açılış “(” sembolü eksikti. Düzeltildikten sonra tekrar kaydetmeyi deneyin. Kodunuzu kaydedebildiğinizde Google, kod söz diziminizin uygun olduğunu düşünür.

Bu, kodunuzun istendiği gibi çalışacağı anlamına gelmez, sadece herhangi bir sözdizimi sorunu olmadan "iyi derleyebileceği" anlamına gelir.

Google Komut Dosyanızı Çalıştırma

Şimdi kodunuzda gezinmek için üstteki oynat simgesini seçin. Yeni komut dosyanızı ilk kez çalıştırdığınız için Google Script uygulamasına Google Hesabınızdaki e-tablonuza (verilerinize) erişim izni vermeniz gerekir. seçmek İzinleri İnceleyin tıklayın.

Google hesabınızda oturum açmanız gerekir. Bu özel bir uygulama olduğundan ve Google'da kayıtlı bir uygulama olmadığından, uygulamanın doğrulanmadığına dair bir uyarı görürsünüz. Seçin ileri bağlantıyı seçin ve ardından Örnek Google Script'e gidin (güvenli değil) devam etmek.

Bir sonraki ekranda, İzin vermek Google Script'in Google hesabınıza erişmesine izin vermek için. Bunu yaptıktan sonra komut dosyası çalışacaktır.

Herhangi bir hata görmüyorsanız, e-tabloya geri dönün ve komut dosyanızdan elde edilen sonuçların ilk sütunun altında göründüğünü görmelisiniz.

Gelişmiş Google Komut Dosyaları Yazma

Bu, hücreleri tek bir sütuna ekleyen çok temel bir Google betiğiydi. Koddaki iki For döngüsüne değişken eklemek istiyorsanız, tüm sütunlarda da döngü oluşturabilir ve tümü için satır 7'de bir özet sağlayabilirsiniz.

Google Scripts, aşağıdakiler gibi her türlü olanağı sunar: e-tablodan e-posta gönderme. Hatta özel Google API'ları Gmail, Takvim ve hatta Google Analytics gibi diğer Google uygulamalarını entegre etmenize olanak tanır. Google komut dosyalarını nasıl yazacağınızı öğrenmeye başladığınızda, olanaklar sınırsızdır.