Google Apps Komut Dosyası, Google E-Tablolar'la yeni ve etkileyici ş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 tasarlanan çoğu komut dosyası, dizileri manipüle ederek Elektronik tablolardaki hücreler, satırlar ve sütunlarla etkileşimde bulunun. 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 genel yöntemler: komut dosyasının kullanıcısı bir e-tablo oluşturabiliyorsa veya bu e-tabloyu e-tablo için uygun izinleri içerir ve bir komut dosyası da bağlı olan bir e-tabloya komut dosyasına, kullanıcı arayüzünü değiştirmek veya e-tablo açılır. 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 almak için veri türünün bulunduğu e-tabloya erişebilmeniz gerekir. depoladığınızda, e-tabloda verilerin bulunduğu aralığı alın ve ardından hücrelerinin değerleri. 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
Yeni ürün adı ve numarası gibi verileri e-tablo kullanıyorsanız 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. içeriğini görmek istiyorsanız HTML hizmeti kılavuzu.
Ayrıca, bir dosyanın içindeki bir resme veya çizime elektronik tablo bir 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 bkz. Google E-Tablolar Makroları.
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. Yüklenebilir ancak tetikleyiciler basit tetikleyicilere ve destekleyicilere kıyasla daha fazla esneklik şu etkinlikler: açma, düzenleme, değiştirme, form gönderme ve zaman odaklı (saat).