Google E-Tablolar'ı genişletme

Google Apps Komut Dosyası, Google E-Tablolar ile yeni ve ilginç şeyler yapmanıza olanak tanır. Şunları yapabilirsiniz: özel menüler eklemek için Apps Komut Dosyası'nı kullanabilirsiniz. iletişim kutularını ve kenar çubuklarını Google E-Tablolar'a ekleyin. Aynı zamanda özel işlevler yazmanıza E-Tablolar'ı, E-Tablolar'ı, E-Tablolar'ı Takvim, Drive ve gibi Google hizmetleri Gmail

Google E-Tablolar için tasarlanmış komut dosyalarının çoğu, bir e-tablodaki hücreler, satırlar ve sütunlarla etkileşim kurmak için dizileri işler. Google JavaScript'teki dizilere aşina olan Codecademy, diziler için mükemmel eğitim modülü mevcut. (Bu kursun Google tarafından geliştirilmediğini ve Google ile ilişkili olmadığını unutmayın.)

Google E-Tablolar ile Apps Komut Dosyası'nı kullanmaya ilişkin kısa bir tanıtım için bkz. Şunun için 5 dakikalık hızlı başlangıç kılavuzu: Makrolar, Menüler ve Özel İşlevler.

Başlayın

Apps Komut Dosyası, programlı bir şekilde oluşturma, okuma ve yazma işlemi yapmanızı sağlayan özel API'ler içerir. Google E-Tablolar’ı düzenleyin. Apps Komut Dosyası, Google E-Tablolar ile iki farklı şekilde etkileşim kurabilir: Komut dosyasının kullanıcısı e-tablo için uygun izinlere sahipse herhangi bir komut dosyası e-tablo oluşturabilir veya mevcut bir e-tabloyu değiştirebilir. Ayrıca, komut dosyası bir e-tabloya bağlı olabilir. Bu durumda, komut dosyası kullanıcı arayüzünü değiştirme veya e-tablo açıldığında yanıt verme gibi özel özelliklere sahip olur. Bağlı komut dosyası oluşturmak için Uzantılar > Apps Komut Dosyası'nı ziyaret edin. Google E-Tablolar

E-tablo hizmeti, Google Izgara modunda E-tablolar, iki boyutlu dizilerle çalışır. Verileri e-tablodan almak için verilerin depolandığı e-tabloya erişmeniz, e-tablodaki verileri içeren aralığı almanız ve ardından hücrelerin değerlerini almanız gerekir. Apps Komut Dosyası, okuma yaparak verilere erişimi kolaylaştırır e-tablodaki yapılandırılmış verileri kullanmak ve bunlar için JavaScript nesneleri oluşturmaktır.

Verileri okuma

Mağazalarınızda yer alan ürün adları ve ürün numaralarının bir listesine sahip olduğunuzu varsayalım. aşağıdaki resimde gösterildiği gibi bir e-tablo oluşturun.

Aşağıdaki örnekte, ürün adları ve ürünün nasıl alınıp günlüğe kaydedileceği gösterilmektedir numaraları'na dokunun.

function logProductInfo() {
  var sheet = SpreadsheetApp.getActiveSheet();
  var data = sheet.getDataRange().getValues();
  for (var i = 0; i < data.length; i++) {
    Logger.log('Product name: ' + data[i][0]);
    Logger.log('Product number: ' + data[i][1]);
  }
}

Günlükleri göster

Günlüğe kaydedilen verileri görüntülemek için komut dosyası düzenleyicisinin en üstündeki Yürütme günlüğü.

Veri yazma

E-tabloya yeni ürün adı ve numarası gibi verileri depolamak için komut dosyasının sonuna aşağıdaki kodu ekleyin.

function addProduct() {
  var sheet = SpreadsheetApp.getActiveSheet();
  sheet.appendRow(['Cotton Sweatshirt XL', 'css004']);
}

Yukarıdaki kod, e-tablonun alt kısmına değerleri belirtildi. Bu işlevi çalıştırırsanız şuraya yeni bir satır eklendiğini görürsünüz: e-tablo kullanarak yapabilirsiniz.

Özel menüler ve kullanıcı arayüzleri

Özel menüler, iletişim kutuları ve kenar çubukları. Menü oluşturmanın temellerini öğrenmek için menüler rehberi. İletişim kutusunun içeriğini özelleştirme hakkında bilgi edinmek için HTML hizmeti kılavuzuna bakın.

Ayrıca, bir dosyanın içindeki bir resme veya çizime elektronik tablo kullanıcı resmi tıkladığında veya çizim. Daha fazla bilgi edinmek için Google E-Tablolar'da Resimler ve Çizimler başlıklı makaleyi inceleyin.

Özel arayüzünüzü eklentiyi öğrenmek için stil kılavuzu ile tutarlı olması için stiline ve düzenine dikkat edin.

Google Formlar'a bağlanılıyor

Apps Komut Dosyası, Google Formlar'ı kullanarak Google E-Tablolar'ı Formlar ve E-tablo hizmetleri. Bu özellik bir e-tablodaki verilere dayalı olarak otomatik olarak bir Google Formu oluşturabilir. Apps Komut Dosyası ayrıca tetikleyicileri kullanmanıza olanak tanır. Örneğin, onFormSubmit: Bir kullanıcı forma yanıt verdikten sonra belirli bir işlemi gerçekleştirmek için. Google E-Tablolar'ı Google Formlar'a bağlama hakkında daha fazla bilgi edinmek için Yönetici Yanıtlar: Google Formlar 5 dakikalık hızlı başlangıç kılavuzu.

Biçimlendirme

Range sınıfının aşağıdakilere benzer yöntemleri vardır: setBackground(color) kullanarak bir hücrenin veya hücre aralığının biçimini değiştirebilirsiniz. Aşağıdakiler örnek, bir aralığın yazı tipi stilini nasıl ayarlayabileceğinizi gösterir:

function formatMySpreadsheet() {
  // Set the font style of the cells in the range of B2:C2 to be italic.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];
  var cell = sheet.getRange('B2:C2');
  cell.setFontStyle('italic');
}

Veri doğrulama

Apps Komut Dosyası, Google E-Tablolar'daki mevcut veri doğrulama kurallarına erişmenize olanak tanır veya yeni kurallar oluşturabilirsiniz. Örneğin, aşağıdaki örnekte bir bir hücrede yalnızca 1 ile 100 arasındaki sayılara izin veren veri doğrulama kuralı.

function validateMySpreadsheet() {
  // Set a rule for the cell B4 to be a number between 1 and 100.
  var cell = SpreadsheetApp.getActive().getRange('B4');
  var rule = SpreadsheetApp.newDataValidation()
     .requireNumberBetween(1, 100)
     .setAllowInvalid(false)
     .setHelpText('Number must be between 1 and 100.')
     .build();
  cell.setDataValidation(rule);
}

Veri doğrulama kurallarıyla çalışma hakkında daha fazla bilgi için SpreadsheetApp.newDataValidation() DataValidationBuilder, ve Range.setDataValidation(rule)

Listeler

Apps Komut Dosyası, bir e-tablodaki verileri temsil eden grafikleri belirli bir aralık. Aşağıdaki örnekte, rastgele hale getirildiği için A1:B15 hücrelerinde grafikleştirilebilir verileriniz var:

function newChart() {
  // Generate a chart representing the data in the range of A1:B15.
  var ss = SpreadsheetApp.getActiveSpreadsheet();
  var sheet = ss.getSheets()[0];

  var chart = sheet.newChart()
     .setChartType(Charts.ChartType.BAR)
     .addRange(sheet.getRange('A1:B15'))
     .setPosition(5, 5, 0, 0)
     .build();

  sheet.insertChart(chart);
}

E-tablonuza grafik yerleştirme hakkında daha fazla bilgi edinmek için bkz. EmbeddedChart ve belirli grafik oluşturucular, EmbeddedPieChartBuilder.

Google E-Tablolar'da özel işlevler

Özel işlev yerleşik e-tablo işlevini (=SUM(A1:A5) gibi) işlevlerinin Apps Komut Dosyası ile davranışını inceleyeceğiz. Örneğin, aylık bazda işlevi (in2mm()), inçten milimetreye dönüştüren bir değer, ardından bir sütuna =in2mm(A1) veya =in2mm(10) yazarak e-tablonuzdaki formülü hücresi

Özel işlevler hakkında daha fazla bilgi edinmek için şunu deneyin: Menüler ve Özel İşlevler 5 dakikalık hızlı başlangıç kılavuzu veya daha ayrıntılı özel işlevler rehberi.

Makrolar

Makrolar, Apps Komut Dosyası kodunu Google E-Tablolar kullanıcı arayüzünden çalıştırmanın başka bir yoludur. Özel işlevlerden farklı olarak bunları bir klavye kısayoluyla veya Google E-Tablolar menüsünü kullanın. Daha fazla bilgi için Google E-Tablolar makroları başlıklı makaleyi inceleyin.

Google E-Tablolar için eklentiler

Eklentiler, özel olarak paketlenmiş Apps Komut Dosyası'dır. Google E-Tablolar'da çalıştırılan ve yüklenebilen projeler Google E-Tablolar eklenti mağazasından indirin. Google E-Tablolar için komut dosyası geliştirdiyseniz ve bunu tüm dünyayla paylaşmak isterseniz Apps Komut Dosyası, komut dosyanızı bir eklenti olarak kullanabilirsiniz.

Tetikleyiciler

Bir Google E-Tablolar dosyasına bağlı komut dosyaları Google Analytics 4'teki işlevler gibi basit tetikleyiciler Düzenleme yapan bir kullanıcı olduğunda otomatik olarak yanıt verecek şekilde onOpen() ve onEdit() erişim e-tabloyu açar veya düzenler.

Basit tetikleyiciler gibi yüklenebilir tetikleyiciler, Google E-Tablolar'ın belirli bir etkinlik gerçekleştiğinde bir işlevi otomatik olarak çalıştırmak. Ancak yüklenebilir tetikleyiciler, basit tetikleyicilere kıyasla daha fazla esneklik sunar ve aşağıdaki etkinlikleri destekler: açma, düzenleme, değiştirme, form gönderme ve zamana dayalı (saat).