Google E-Tablolar ile Apps Komut Dosyası'nın Temelleri #2: E-Tablolar, Sayfalar ve Aralıklar

1. Giriş

Google E-Tablolar ile Apps Komut Dosyası'nın Temelleri adlı codelab oynatma listesinin ikinci bölümüne hoş geldiniz. Önceki codelab'de komut dosyası düzenleyici, makrolar ve özel işlevler kavramlarına odaklanılmıştı. Bu codelab'de, Google E-Tablolar'da veri okumak, yazmak ve işlemek için kullanabileceğiniz Spreadsheet hizmeti ayrıntılı olarak ele alınmaktadır.

Neler öğreneceksiniz?

• E-tabloların, sayfaların ve aralıkların Apps Komut Dosyası'nda nasıl gösterildiği.
• SpreadsheetApp ve Spreadsheet sınıfıyla etkin (açık) e-tabloya erişme, e-tablo oluşturma ve e-tabloyu yeniden adlandırma
• Sheet sınıfını kullanarak bir sayfanın adını ve bir aralığın sütun/satır yönünü değiştirme
• Range sınıfını kullanarak bir hücre grubunu veya veri aralığını belirtme, etkinleştirme, taşıma ve sıralama

Başlamadan önce

Bu codelab, Google E-Tablolar ile Apps Komut Dosyası'nın Temelleri oynatma listesindeki ikinci codelab'dir. Başlamadan önce Makrolar ve Özel İşlevler adlı ilk codelab'i tamamladığınızdan emin olun.

İhtiyacınız olanlar

• Bu oynatma listesinin önceki kod laboratuvarında ele alınan temel Apps Komut Dosyası konularını anlamış olmanız gerekir.
• Apps Komut Dosyası düzenleyici hakkında temel bilgi
• Google E-Tablolar'ı temel düzeyde kullanabilme
• E-Tablolar A1 Notasyonunu okuma özelliği
• JavaScript ve String sınıfı hakkında temel düzeyde bilgi sahibi olma

Bir sonraki bölümde, E-Tablo hizmetinin temel sınıfları tanıtılmaktadır.

2. E-tablo hizmetine giriş

E-Tablolar hizmetinin temelini dört sınıf oluşturur: SpreadsheetApp, Spreadsheet, Sheet ve Range. Bu bölümde, bu sınıflar ve hangi amaçlarla kullanıldıkları açıklanmaktadır.

SpreadsheetApp Sınıfı

E-tabloları, sayfaları ve aralıkları incelemeden önce üst sınıflarını gözden geçirmeniz gerekir: SpreadsheetApp. Birçok komut dosyası, Google E-Tablolar dosyalarınıza ilk erişim noktasını sağlayabildikleri için SpreadsheetApp yöntemlerini çağırarak başlar. SpreadsheetApp, Spreadsheet hizmetinin ana sınıfı olarak düşünülebilir. SpreadsheetApp sınıfı burada ayrıntılı olarak ele alınmamıştır. Ancak bu codelab'in ilerleyen bölümlerinde, bu sınıfı anlamanıza yardımcı olacak hem örnekler hem de alıştırmalar bulabilirsiniz.

E-tablolar, sayfalar ve sınıfları

E-Tablolar terimi olarak e-tablo, satır ve sütunlara göre düzenlenmiş veriler içeren bir Google E-Tablolar dosyasıdır (Google Drive'da depolanır). E-tablolar bazen "Google E-Tablosu" olarak da adlandırılır. Dokümanlar ise "Google Dokümanı" olarak adlandırılır.

Google E-Tablolar dosya verilerine erişmek ve bunları değiştirmek için Spreadsheet sınıfını kullanabilirsiniz. Bu sınıfı, ortak çalışan ekleme gibi diğer dosya düzeyindeki işlemler için de kullanabilirsiniz.

Sayfa** bir e-tablonun bağımsız sayfasını temsil eder ve bazen "sekme" olarak da adlandırılır. Her e-tablo bir veya daha fazla sayfa içerebilir. Sayfa düzeyindeki verilere ve ayarlara (ör. veri satırlarını veya sütunlarını taşıma) erişmek ve bunları değiştirmek için Sheet** sınıfını kullanabilirsiniz.

Önemli nokta: E-tabloların adının yanı sıra, ilgili sayfaya özgü bir kimlik dizesi de vardır. Kimlik, e-tablonun URL'sinde şu biçimde yer alır:

https://docs.google.com/spreadsheets/d/spreadsheetID/edit#gid=0

Bir e-tablodaki her sayfanın da e-tabloya özgü bir kimlik numarası vardır. Bu kimlik numarası rastgele oluşturulur ancak e-tablo URL'sinde şu biçimde de görebilirsiniz:

https://docs.google.com/spreadsheets/d/spreadsheetID/edit#gid=sheetID

Bu örnek URL'de her iki kimliği de görebilirsiniz:

E-tabloların ve sayfaların kimlikleri benzersiz olduğundan (e-tablo adları benzersiz değildir) mümkün olduğunda e-tabloları ve sayfaları belirtmek için kimlikleri kullanmak daha iyidir. Örneğin, Google Drive'ınızda aynı ada sahip birden fazla e-tablo olabilir. E-tablolarınızı açmak için SpreadsheetApp.openById(id) gibi komut dosyası yöntemlerini kullanarak yanlışlıkla yanlış dosyayı düzenlemeyi önleyebilirsiniz.

Google E-Tablolar'a Giriş başlıklı makaleyi inceleyerek Google E-Tablolar'daki kimlikler hakkında daha fazla bilgi edinin.

Özetle, Spreadsheet sınıfı, e-tablolar koleksiyonu üzerinde çalışır ve Google Drive'da bir Google E-Tablolar dosyası tanımlar. Sheet sınıfı, bir e-tablodaki ayrı ayrı sayfalarda çalışır.

Range sınıfı

Çoğu veri işleme işlemi (ör. hücre verilerini okuma, yazma veya biçimlendirme), işlemin hangi hücrelere uygulanacağını tanımlamanızı gerektirir. Bir sayfada belirli hücre gruplarını seçmek için Range sınıfını kullanabilirsiniz. Bu sınıfın örnekleri, bir sayfadaki bir veya daha fazla bitişik hücre grubunu temsil eden bir aralığı ifade eder. Aralıkları satır ve sütun numaralarına göre veya A1 notasyonunu kullanarak belirtebilirsiniz.

Önemli terim: Apps Komut Dosyası'nda etkin sayfa, Google E-Tablolar arayüzünde şu anda açık ve görünür olan sayfadır. Benzer şekilde, etkin aralık, etkin sayfada şu anda vurgulanan bir veya daha fazla hücrenin oluşturduğu gruptur. Etkin hücre, etkin sayfada imlecin odaklandığı, vurgulanmış tek hücredir.

Birçok sınıf yöntemi, istenen sınıfın etkin nesnesini döndürür. Örneğin, SpreadsheetApp.getActiveSpreadsheet() komutunu çalıştırmak kullanıcının etkin veya mevcut e-tablosunu döndürür. Etkin e-tabloyu alarak bu e-tabloya işlemler uygulayabilirsiniz. Benzer şekilde, Sheet.activate() yöntemi gibi yöntemler etkin nesneyi değiştirebilir.

Bir sayfayı, aralığı veya hücreyi etkinleştirmek, Google E-Tablolar arayüzünde ilgili sayfayı, aralığı ya da hücreyi tıklamaya eşdeğerdir. Bu işlem, imleç odağını ilgili konuma taşır.

Bu codelab'in geri kalanında, bu sınıflarla ve yöntemleriyle çalışan komut dosyalarına örnekler verilmektedir.

3. Kur

Devam etmeden önce bazı verilerin bulunduğu bir e-tabloya ihtiyacınız var. Sizin için bir tane hazırladık: Veri sayfasını kopyalamak için bu bağlantıyı, ardından Kopya oluştur'u tıklayın.

Kullanabileceğiniz örnek e-tablonun bir kopyası, Google Drive klasörünüze yerleştirilir ve "Başlıksız e-tablonun kopyası" olarak adlandırılır. Bu codelab'deki alıştırmaları tamamlamak için bu e-tabloyu kullanın.

Komut dosyası düzenleyicisini Google E-Tablolar'dan Uzantılar > Apps Komut Dosyası'nı tıklayarak açabileceğinizi hatırlatırız.

Bir Apps Komut Dosyası projesini komut dosyası düzenleyicisinde ilk kez açtığınızda, komut dosyası düzenleyicisi sizin için hem bir komut dosyası projesi hem de bir komut dosyası oluşturur.

Sonraki bölümde, bu e-tabloyu iyileştirmek için Spreadsheet sınıfını nasıl kullanacağınız gösterilmektedir.

4. E-tablolara erişme ve bunları değiştirme

Bu bölümde, e-tablolara erişmek ve bunları değiştirmek için SpreadsheetApp ve Spreadsheet sınıflarını nasıl kullanacağınızı öğrenebilirsiniz. Bu alıştırmalar, e-tabloları yeniden adlandırmayı ve e-tablo içindeki sayfaları çoğaltmayı öğretir.

Bunlar basit işlemler olsa da genellikle daha büyük ve karmaşık bir iş akışının parçasıdır. Bu görevleri komut dosyası koduyla nasıl otomatikleştireceğinizi anladığınızda daha ayrıntılı işlemleri nasıl otomatikleştireceğinizi öğrenmek kolaylaşır.

Etkin e-tabloyu yeniden adlandırma

Örneğin, varsayılan ad olan "Başlıksız e-tablonun kopyası"nı, e-tablonuzun amacını daha iyi yansıtan bir başlıkla değiştirmek istediğinizi varsayalım. Bu işlemi SpreadsheetApp ve Spreadsheet sınıflarıyla yapabilirsiniz.

1. Komut dosyası düzenleyicide varsayılan myFunction() kod bloğunu aşağıdaki kodla değiştirin:

function renameSpreadsheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  mySS.rename("2017 Avocado Prices in Portland, Seattle");
}

2. Senaryonuzu kaydetmek için Kaydet'i tıklayın.
3. Apps Komut Dosyası projenizi yeniden adlandırmak için Adsız proje'yi tıklayın, yeni proje adı olarak "Avokado fiyatları"nı girin ve Yeniden adlandır'ı tıklayın.
4. Komut dosyanızı çalıştırmak için işlev listesinden renameSpreadsheet simgesini seçin ve Çalıştır'ı tıklayın.
5. Ekrandaki talimatları uygulayarak makroyu yetkilendirin. "Bu uygulama doğrulanmadı" mesajını alırsanız Gelişmiş'i, ardından Avokado fiyatlarına git (güvenli değil)'i tıklayın. Sonraki ekranda İzin ver'i tıklayın.

Not: gmail.com hesabı kullanıyorsanız komut dosyanızı ilk kez kullandığınızda doğrulanmamış uygulama iletişim kutusu görebilirsiniz. Google, bilinmeyen veya güvenilmeyen yazarlardan kod kullanan kullanıcıları uyarmak için bu bilgiyi kullanır. Bu iletişim kutusunu görüyorsanız komut dosyasının yazarı olduğunuz için devam edebilirsiniz. Komut dosyasını yetkilendirmeye devam etmek için ekrandaki istemleri uygulayın.

İşlev yürütüldüğünde e-tablonuzun dosya adı değişir:

Girdiğiniz koda bakalım. getActiveSpreadsheet() yöntemi, etkin e-tabloyu temsil eden bir nesne döndürür. Bu, alıştırma e-tablosunun oluşturduğunuz kopyasıdır. Bu e-tablo nesnesi, mySS değişkeninde saklanır. mySS üzerinde rename(newName) işlevini çağırmak, Google Drive'daki e-tablo dosyasının adını "2017 Avocado Prices in Portland, Seattle" olarak değiştirir.

mySS değişkeni e-tabloya bir referans olduğundan, getActiveSpreadsheet() yöntemlerini tekrar tekrar çağırmak yerine mySS üzerinde Spreadsheet yöntemlerini çağırarak kodunuzu daha temiz ve verimli hale getirebilirsiniz.

Etkin sayfayı kopyalama

Mevcut e-tablonuzda yalnızca bir sayfa var. Sayfanın kopyasını oluşturmak için Spreadsheet.duplicateActiveSheet() yöntemini çağırabilirsiniz:

1. Komut dosyası projenizde bulunan renameSpreadsheet() işlevinin altına aşağıdaki yeni işlevi ekleyin:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();
}

2. Senaryo projenizi kaydedin.
3. Komut dosyanızı çalıştırmak için işlev listesinden duplicateAndOrganizeActiveSheet simgesini seçin ve Çalıştır'ı tıklayın.

E-tablonuza yeni bir "Sheet_Original Kopyası" sayfa sekmesinin eklendiğini görmek için E-Tablolar'a dönün.

Bu yeni işlevde, duplicateActiveSheet() yöntemi, e-tablonuzda yinelenen sayfayı oluşturur, etkinleştirir ve döndürür. Ortaya çıkan bu sayfa duplicateSheet konumunda saklanır ancak kod henüz bu değişkenle ilgili herhangi bir işlem yapmaz.

Sonraki bölümde, Sheet sınıfını kullanarak yinelenen sayfayı yeniden adlandırıp biçimlendireceksiniz.

5. Sayfanızı Sheet sınıfıyla biçimlendirme

Sheet sınıfı, komut dosyalarının sayfaları okumasına ve güncellemesine olanak tanıyan yöntemler sunar. Bu bölümde, Sheet sınıfındaki yöntemlerle bir sayfanın adını ve sütun genişliklerini nasıl değiştireceğinizi öğrenebilirsiniz.

Not**: Spreadsheet** ve Sheet sınıfları, Spreadsheet.deleteColumn(columnPosition) ve Sheet.deleteColumn(columnPosition) gibi birçok ortak sayfaya özgü yöntemi paylaşır.

Spreadsheet.deleteColumn(columnPosition) yöntemini çağırdığınızda, e-tablodaki etkin (açık) sayfadan sütunlar kaldırılır. getActiveSheet()'ı ve ardından Sheet.deleteColumn(columnPosition)'ı arayarak aynı sonucu elde edebilirsiniz. Spreadsheet sürümü, zamandan tasarruf etmenizi sağlar.

Sayfanın adını değiştirme

Sayfaları yeniden adlandırmak, renameSpreadsheet()'da e-tabloları yeniden adlandırmak kadar kolaydır. Yalnızca tek bir yöntem çağrısı gereklidir.

1. Google E-Tablolar'da, etkinleştirmek için Sheet_Original sayfasını tıklayın.
2. Apps Komut Dosyası'nda duplicateAndOrganizeActiveSheet() işlevinizi aşağıdakiyle eşleşecek şekilde değiştirin:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());
}

3. İşlevi kaydedip çalıştırın.

Google E-Tablolar'da, işlevi çalıştırdığınızda yinelenen bir sayfa oluşturulur ve yeniden adlandırılır:

Eklenen kodda, setName(name) yöntemi, duplicateSheet'ün adını değiştirir ve sayfanın benzersiz kimlik numarasını almak için getSheetID() kullanır. + operatörü, sayfa kimliğini "Sheet_" dizesinin sonuna ekler.

Sayfanın sütunlarını ve satırlarını değiştirme

Sayfanızı biçimlendirmek için Sheet sınıfını da kullanabilirsiniz. Örneğin, duplicateAndOrganizeActiveSheet() işlevinizi, yinelenen sayfanın sütunlarını da yeniden boyutlandıracak ve dondurulmuş satırlar ekleyecek şekilde güncelleyebiliriz:

1. Google E-Tablolar'da, etkinleştirmek için Sheet_Original sayfasını tıklayın.
2. Apps Komut Dosyası'nda duplicateAndOrganizeActiveSheet() işlevinizi aşağıdakiyle eşleşecek şekilde değiştirin:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);
}

3. İşlevi kaydedip çalıştırın.

Google E-Tablolar'da, yinelenen bir sayfa oluşturulur, yeniden adlandırılır, etkinleştirilir ve biçimlendirilir:

Eklediğiniz kod, okunabilirlik için e-tablonun sütunlarını yeniden boyutlandırmak üzere autoResizeColumns(startColumn, numColumns) kullanıyor. setFrozenRows(rows) yöntemi, belirtilen sayıda satırı (bu örnekte iki) dondurur. Böylece, okuyucu e-tabloda aşağı kaydırdıkça başlık satırları görünür kalır.

Not: Apps Komut Dosyası'nda dizilerle çalışırken listenin 0 dizininden başladığı kuralına uyulur. Ancak satır ve sütunlarla çalışırken dizin 1'den başlar. Bu mantık, E-Tablolar'da 1. satır ve A sütunundan başladığınız geleneksel e-tablo biçimlendirmesiyle uyumludur.

autoResizeColumns(startColumn, numColumns) gibi sütun ve satırlarla ilgili yöntemleri kullanırken bunu göz önünde bulundurun. Mevcut alıştırmamızda, duplicateSheet'nın A sütununa referans vermek için parametre olarak 1 (0 değil) giriyorsunuz.

Sonraki bölümde aralıklar ve temel veri işleme hakkında bilgi edineceksiniz.

6. Verileri Range sınıfıyla yeniden düzenleme

Range sınıfı ve yöntemleri, Spreadsheet hizmetindeki veri işleme ve biçimlendirme seçeneklerinin çoğunu sağlar.

Bu bölümde, aralıklarla temel veri işleme tanıtılmaktadır. Bu alıştırmalar, Apps Komut Dosyası'nda aralıkların nasıl kullanılacağına odaklanırken bu oynatma listesindeki diğer codelab'lerde veri işleme ve veri biçimlendirme konuları daha ayrıntılı olarak ele alınır.

Aralıkları taşıma

Sınıf yöntemleri ve A1 gösterimi ile veri aralıklarını etkinleştirebilir ve taşıyabilirsiniz. A1 gösterimi, e-tablolardaki belirli hücre kümelerini tanımlamak için kullanılan bir kısaltmadır. Bilgilerinizi tazelemek isterseniz A1 gösterimiyle ilgili bu açıklamaya göz atabilirsiniz.

Bazı verileri de taşımak için duplicateAndOrganizeActiveSheet() yönteminizi güncelleyelim:

1. Google E-Tablolar'da, etkinleştirmek için Sheet_Original sayfasını tıklayın.
2. Apps Komut Dosyası'nda duplicateAndOrganizeActiveSheet() işlevinizi aşağıdakiyle eşleşecek şekilde değiştirin:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);

  // Move column F to column C.
  var myRange = duplicateSheet.getRange("F2:F");
  myRange.moveTo(duplicateSheet.getRange("C2"));
}

3. İşlevi kaydedip çalıştırın.

Bu işlevi çalıştırdığınızda, yinelenen bir sayfa oluşturulur, etkinleştirilir ve biçimlendirilir. Ayrıca, F sütununun içeriği C sütununa taşınır:

Yeni kod, taşınacak veri aralığını belirlemek için getRange(a1Notation) yöntemini kullanır. Yöntemin parametresi olarak A1 gösterimi "F2:F" değerini girerek F sütununu (F1 hariç) belirtirsiniz. Belirtilen aralık varsa getRange(a1Notation) yöntemi, Range örneğini döndürür. Kod, kolaylık sağlamak için örneği myRange değişkeninde saklar.

Aralık belirlendikten sonra moveTo(target) yöntemi, myRange'ün içeriğini (hem değerler hem de biçimlendirme) alır ve taşır. Hedef (C sütunu), A1 gösterimi "C2" kullanılarak belirtilir. Bu, sütun değil tek bir hücredir. Verileri taşırken boyutları hedef ve hedef aralıklarla eşleştirmeniz gerekmez. Apps Komut Dosyası, her birinin ilk hücresini hizalar.

Not: Kendi komut dosyalarınızı yazarken verilerinizin istediğiniz yerde olduğundan emin olmak için bunları kapsamlı bir şekilde test edin. Apps Komut Dosyası, hücre değerlerini değiştirirken mevcut veri değerlerinin üzerine yazar. Dikkatli olmazsanız saklamak istediğiniz verilerin üzerine yazabilirsiniz. Bu örnekte C sütunu boştu ancak orada veri olsaydı moveTo(target) yöntemi bu verileri kaldırırdı.

Aralıkları sıralama

Range sınıfı, hücre gruplarını okumanıza, güncellemenize ve düzenlemenize olanak tanır. Örneğin, Range.sort(sortSpecObj) yöntemini kullanarak bir veri aralığını sıralayabilirsiniz:

1. Google E-Tablolar'da, etkinleştirmek için Sheet_Original sayfasını tıklayın.
2. Apps Komut Dosyası'nda duplicateAndOrganizeActiveSheet() işlevinizi aşağıdakiyle eşleşecek şekilde değiştirin:

function duplicateAndOrganizeActiveSheet() {
  var mySS = SpreadsheetApp.getActiveSpreadsheet();
  var duplicateSheet = mySS.duplicateActiveSheet();

  // Change the name of the new sheet.
  duplicateSheet.setName("Sheet_" + duplicateSheet.getSheetId());

  // Format the new sheet.
  duplicateSheet.autoResizeColumns(1, 5);
  duplicateSheet.setFrozenRows(2);

  // Move column F to column C.
  var myRange = duplicateSheet.getRange("F2:F");
  myRange.moveTo(duplicateSheet.getRange("C2"));

  // Sort all the data using column C (Price information).
  myRange = duplicateSheet.getRange("A3:D55");
  myRange.sort(3);
}

3. İşlevi kaydedip çalıştırın.

Artık işlev, önceki biçimlendirmemize ek olarak tablodaki tüm verileri C sütunundaki fiyat bilgilerini kullanarak sıralıyor:

Yeni kod, A3:D55 aralığını (sütun başlıkları hariç tüm tablo) kapsayan yeni bir aralık belirtmek için getRange(a1Notation) kullanır. Ardından kod, tabloyu sıralamak için sort(sortSpecObj) yöntemini çağırır. Burada sortSpecObj parametresi, sıralama yapılacak sütun numarasıdır. Bu yöntem, aralığı belirtilen sütun değerleri en düşükten en yükseğe (artan değerler) gidecek şekilde sıralar. sort(sortSpecObj) yöntemi daha karmaşık sıralama koşullarını karşılayabilir ancak burada bu koşullara ihtiyacınız yoktur. Sıralama aralıklarını çağırmanın tüm farklı yollarını yöntem referans belgelerinde görebilirsiniz.

Tebrikler, codelab'deki tüm alıştırmaları başarıyla tamamladınız. Bir sonraki bölümde bu codelab'in önemli noktaları incelenmekte ve bu oynatma listesindeki bir sonraki codelab'in önizlemesi yapılmaktadır.

7. Sonuç

Bu codelab'in sonuna geldiniz. Artık Apps Komut Dosyası'nda E-tablo hizmetinin temel sınıflarını ve terimlerini kullanıp tanımlayabilirsiniz.

Bir sonraki codelab'e geçmeye hazırsınız.

Bu codelab'i faydalı buldunuz mu?

Evet Hayır

İşlediğimiz konular

• E-tabloların, sayfaların ve aralıkların Apps Komut Dosyası'nda nasıl gösterildiği.
• SpreadsheetApp, Spreadsheet, Sheet ve Range sınıflarının bazı temel kullanımları.

Temel Kavramlar:

1. Apps Komut Dosyası'nda tüm diziler, listenin 0 dizininden başladığı kuralına uyar. Ancak satırlar ve sütunlar 1'den başlayarak indekslenir.
2. Apps Komut Dosyası'nda, şu anda açık olan sayfa, vurgulanan aralık ve hücre etkin olarak kabul edilir. Birçok Apps Komut Dosyası yöntemi, etkin öğeye erişir veya onu değiştirir.
3. Spreadsheet ve Sheet sınıfları, sayfaya özgü çeşitli yöntemleri paylaşır. Spreadsheet sınıfındaki yinelenen yöntemler, çağrıldıklarında genellikle etkin sayfayı hedefledikleri için yalnızca kullanıcı kolaylığı amacıyla sağlanır.
4. Her e-tablonun ve sayfanın benzersiz bir kimliği vardır. Bu kimliği tarayıcı URL'sinde bulabilirsiniz. E-tablo ve sayfa sınıfı yöntemleri kimlikleri kullanır. Kimlikler ve URL'ler hakkında daha fazla bilgiyi Google E-Tablolar'a Giriş başlıklı makalede bulabilirsiniz.

Anahtar terimler:

• Etkin (durum): Belirtilen e-tablonun, sayfanın, aralığın veya hücrenin, e-tablo kullanıcısının şu anda görüntülediği ya da vurguladığı öğe olduğunu gösterir.
• Etkin hücre: Etkin sayfada imleç odağıyla vurgulanan tek hücre.
• Etkin aralık: Etkin sayfada şu anda vurgulanan bir veya daha fazla hücre grubu.
• Yetkilendirme: Kullanıcının, Apps Komut Dosyası'nın ilgili Google hizmetlerindeki kullanıcı verilerine erişmesine veya kullanıcı adına başka işlemler yapmasına izin verme süreci.
• Kapsayıcıya bağlı komut dosyası: Google E-Tablosu veya Google Dokümanı gibi bir Google Workspace dokümanına bağlı olan ve bu dokümandan oluşturulan tüm komut dosyaları.
• Aralık:** Bir sayfadaki bir veya daha fazla bitişik hücre grubu. Range** sınıfı, bir sayfadaki aralıkları okuma ve güncelleme olanağı sunar.
• Komut dosyası düzenleyici: Apps Komut Dosyası için tarayıcı içi kod düzenleyici.
• Sayfa**: Bir elektronik tablonun tek bir sayfası (Microsoft Excel'deki çalışma kitaplarına benzer). Bazen Google Drive'daki bir Google E-Tablolar dosyası için kullanılır. Sheet** sınıfı, sayfalara erişmenize ve bunları değiştirmenize olanak tanır.
• SpreadsheetApp: Bu sınıf, E-Tablo hizmetinin üst sınıfı olarak işlev görür ve Google E-Tablolar verilerini okuyan veya değiştiren kod için bir başlangıç noktası sağlar.
• E-tablo**: Google Drive'da bulunan bir Google E-Tablolar dosyası. Spreadsheet** sınıfı, e-tablolara erişmenize ve bunları değiştirmenize olanak tanır.
• E-Tablo hizmeti: Komut dosyalarının Google E-Tablolar dosyalarını oluşturmasına, bunlara erişmesine ve bunları değiştirmesine olanak tanıyan bir Apps Komut Dosyası hizmetidir.

Sırada ne var?

Bu oynatma listesindeki bir sonraki codelab'de, e-tablodaki verilerin nasıl okunacağı, yazılacağı ve değiştirileceği daha ayrıntılı olarak açıklanmaktadır.

Bir sonraki codelab'i Verilerle çalışma sayfasında bulabilirsiniz.