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

Google E-Tablolar ile Apps Komut Dosyasının Temelleri 2:

E-Tablolar, E-Tablolar ve Aralıklar

Bu codelab hakkında

Son güncelleme Nis 4, 2022

Yazan: Google Workspace Developer Relations

1. Giriş

Google E-Tablolar ile codelab'in oynatma listesinin ikinci bölümüne hoş geldiniz. Komut dosyası düzenleyicisinin, makroların ve özel işlevler kavramlarına odaklanan önceki codelab'de. Bu codelab'de, Google E-Tablolar'da veri okumak, yazmak ve değiştirmek için kullanabileceğiniz E-tablo hizmetine geçilmiştir.

Neler öğreneceksiniz?

• E-tabloların, e-tabloların ve aralıkların Apps Komut Dosyası'nda nasıl gösterildiği.
• Etkin (açık) e-tabloya SpreadsheetApp ve Spreadsheet sınıfıyla erişme, oluşturma ve yeniden adlandırma.
• Sheet sınıfını kullanarak bir e-tablonun adını ve bir aralık/sütun 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, Google Apps ile Apps Komut Dosyası'nın Temelleri oynatma listesindeki ikinci codelab'dir. Başlamadan önce ilk codelab'i tamamladığınızdan emin olun: Makrolar ve Özel İşlevler.

Gerekenler

• Bu oynatma listesinin önceki codelab'inde incelenen temel Apps Komut Dosyası konuları hakkında bilgi edinin.
• Apps Komut Dosyası düzenleyicisine dair temel bilgi sahibi olma
• Google E-Tablolar'la ilgili temel bilgi sahibi olma
• E-Tablolar A1 Gösterimi'ni okuma özelliği
• JavaScript ve String sınıfı hakkında temel bilgi sahibi olma

Bir sonraki bölümde, E-tablo hizmetinin temel sınıfları açıklanmaktadır.

2. E-tablo hizmetine giriş

E-tablo hizmetinin temelini dört ders oluşturur: SpreadsheetApp, Spreadsheet, Sheet ve Range. Bu bölümde, bu sınıflar ve ne için kullanıldıkları açıklanmaktadır.

spreadsheetApp Sınıfı

E-tabloları, sayfaları ve aralıkları ayrıntılı olarak incelemeden önce üst sınıflarını incelemeniz gerekir: SpreadsheetApp. Birçok komut dosyası, Google E-Tablolar dosyalarınıza ilk erişim noktasını sağlayabileceği için SpreadsheetApp yöntemlerini çağırarak başlar. SpreadsheetApp öğesini, E-tablo hizmetinin ana sınıfı olarak düşünebilirsiniz. SpreadsheetApp sınıfı, burada derinlemesine incelenmiyor. 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, e-tablolar ve sınıfları

E-tablo terimi olarak e-tablo, satır ve sütunlara göre düzenlenmiş verileri içeren bir Google E-Tablolar dosyasıdır (Google Drive'da depolanır). E-tabloya bazen "Google Dokümanı", aynı zamanda dokümanın "Google Dokümanı" olarak da adlandırılır.

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

Sayfa**, bir e-tablonun tek tek sayfasını temsil eder. Bazen "sekme" olarak da adlandırılır. Her e-tablo bir veya daha fazla sayfa içerebilir. Satır veya veri sütunlarının taşınması gibi sayfa düzeyinde verilere ve ayarlara erişmek ve bu ayarları değiştirmek için Sheet** sınıfını kullanabilirsiniz.

Önemli Nokta: E-tablolarda ada ek olarak, o sayfaya özgü bir kimlik dizesi de vardır. Kimlik, e-tablonun URL'sinde şu biçimde bulunur:

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

Ayrıca, bir e-tablodaki her sayfanın bu e-tabloya özgü bir kimlik numarası vardır. Bu kimlik numarası rastgele hale getirilmiştir ancak bunu 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 e-tabloların kimlikleri benzersiz olduğundan (ve e-tablo adları benzersiz olmadığından) mümkün olduğunda e-tabloları ve sayfaları belirtmek için kimlikleri kullanmak daha iyidir. Örneğin, Google Drive'ınızda aynı adı taşıyan birden fazla e-tablonuz olabilir. E-tablolarınızı açmak için SpreadsheetApp.openById(id) gibi komut dosyası yöntemleri kullanarak yanlışlıkla yanlış dosyayı düzenlemekten kaçınabilirsiniz.

Google E-Tablolar'a giriş bölümünü inceleyerek Google E-Tablolar'daki kimlikler hakkında daha fazla bilgi edinebilirsiniz.

Özetle, Spreadsheet sınıfı e-tablo koleksiyonunda çalışır ve Google Drive'da bir Google E-Tablolar dosyası tanımlar. Sheet sınıfı, bir e-tablodaki tek tek sayfalarda çalışır.

Aralık sınıfı

Çoğu veri işleme işlemi (örneğin, hücre verilerini okuma, yazma veya biçimlendirme) işlemin hangi hücreler için geçerli olduğunu tanımlamanızı gerektirir. Bir sayfa içindeki belirli hücre gruplarını seçmek için Range sınıfını kullanabilirsiniz. Bu sınıfın örnekleri, bir aralığı (sayfadaki bir veya daha fazla bitişik hücre grubu) temsil eder. Aralıkları satır ve sütun numaralarına göre veya A1 gösterimini kullanarak belirtebilirsiniz.

Anahtar terim: Apps Komut Dosyası'nda etkin sayfa, Google E-Tablolar arayüzünde şu anda açık olan ve görünen sayfadır. Benzer şekilde etkin aralık, etkin sayfada hâlihazırda vurgulanan bir veya daha fazla hücre grubudur. Etkin hücre, imleç odağının etkin olduğu tek bir vurgulanan hücredir.

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

Bir sayfanın, aralığın veya hücrenin etkinleştirilmesi Google E-Tablolar arayüzünde bu sayfanın, aralığın veya hücrenin tıklanmasıyla imleç odağının o konuma taşınmasını sağlar.

Codelab'in geri kalanında, bu sınıflarla çalışan komut dosyaları ve bunların yöntemleri gösterilir.

3. Kur

Devam etmeden önce bazı verilerin bulunduğu bir e-tabloya ihtiyacınız var. Sizin için bir resim URL'si sağladık: Veri sayfasını kopyalamak için bu bağlantıyı tıklayın ve 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 “Adsız e-tablonun kopyası” olarak adlandırılır. Bu codelab alıştırmalarını tamamlamak için bu e-tabloyu kullanın.

Uzantılar > Apps Komut Dosyası'nı tıklayarak Google E-Tablolar'da komut dosyası düzenleyiciyi açabileceğinizi hatırlatmak isteriz.

Komut dosyası düzenleyicisinde bir Apps Komut Dosyası projesini ilk kez açtığınızda, komut dosyası düzenleyicisi sizin için hem bir komut dosyası projesi hem de bir komut dosyası 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 e-tablolarda değişiklik yapma

Bu bölümde, e-tablolara erişmek ve e-tablolarda değişiklik yapmak için SpreadsheetApp ve Spreadsheet sınıflarını nasıl kullanacağınızı öğrenebilirsiniz. Alıştırmalar, özellikle bir e-tabloyu nasıl yeniden adlandıracağınızı ve bir e-tablodaki sayfaları nasıl kopyalayacağınızı öğretir.

Bunlar basit işlemlerdir ancak genellikle daha büyük ve karmaşık bir iş akışının parçasıdır. Komut dosyası koduyla bu görevleri nasıl otomatikleştireceğinizi anladıktan sonra, daha ayrıntılı işlemleri nasıl otomatik hale getireceğinizi öğrenmek kolaylaşır.

Etkin e-tabloyu yeniden adlandırma

Varsayılan ad olan "Adsız e-tablonun kopyası"nı e-tablonuzun amacını daha iyi yansıtan bir adla değiştirmek istediğinizi varsayalım. Bunu SpreadsheetApp ve Spreadsheet sınıflarıyla yapabilirsiniz.

1. Komut dosyası düzenleyicisinde, 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. Komut dosyanızı kaydetmek için Kaydet'i tıklayın.
3. Apps Komut Dosyası projenizi yeniden adlandırmak için Adsız proje'yi tıklayıp yeni proje adı olarak "Avocado fiyatları" yazın ve Yeniden adlandır'ı tıklayın.
4. Komut dosyanızı çalıştırmak için işlevler listesinden renameSpreadsheet'yi seçin ve Çalıştır'ı tıklayın.
5. Ekrandaki talimatları uygulayarak makroyu yetkilendirin. "Bu uygulama doğrulanmadı" mesajı alırsanız Gelişmiş'i, ardından Avocado fiyatlarına git (güvenli değil) seçeneğini tıklayın. Sonraki ekranda İzin ver'i tıklayın.

Not: Bir gmail.com hesabı kullanıyorsanız komut dosyanızı ilk kez kullandığınızda, doğrulanmamış bir uygulama iletişim kutusu görebilirsiniz. Google, bilinmeyen veya güvenilmeyen yazarların kodlarını kullanıyor olabilecek kullanıcıları uyarmak için bu özelliği kullanır. Bu iletişim kutusunu görürseniz komut dosyası yazarı olduğunuz için devam edebilirsiniz. Komut dosyasını yetkilendirmeye devam etmek için ekrandaki talimatları uygulayın.

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

Girdiğiniz koda göz atalım. getActiveSpreadsheet() yöntemi, etkin e-tabloyu temsil eden bir nesne, yani oluşturduğunuz egzersiz e-tablosunun kopyasını döndürür. Bu e-tablo nesnesi mySS değişkeninde depolanır. mySS adresinde rename(newName) araması Google Drive'daki e-tablo dosyasının adını & Porto, Seattle'da 2017 Avocado Fiyatları olarak değiştiriyor.

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

Etkin sayfayı kopyala

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

1. Aşağıdaki yeni işlevi, zaten komut dosyası projenizdeki renameSpreadsheet() işlevinin altına ekleyin:

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

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

E-tablonuza yeni bir "Sayfa_Orijinali" kopyası sekmesi görmek için E-Tablolar'a dönün.

Bu yeni işlevde duplicateActiveSheet() yöntemi, e-tablonuzdaki yinelenen sayfayı oluşturur, etkinleştirir ve döndürür. Elde edilen bu sayfa duplicateSheet içinde depolanıyor ancak kod bu değişkenle henüz bir şey yapmıyor.

Sonraki bölümde, kopya sayfayı yeniden adlandırmak ve biçimlendirmek için Sheet sınıfını kullanacaksınız.

5. Sayfanızı Sayfa sayfası ile 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ının yöntemleriyle 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 sayfaya özgü birkaç ortak yöntemi paylaşır.

Spreadsheet.deleteColumn(columnPosition) yöntemini çağırdığınızda yöntem, sütunları e-tablodaki etkin ve açık durumdaki sayfadan kaldırır. getActiveSheet() ve ardından Sheet.deleteColumn(columnPosition) numaralı telefonu arayarak aynı sonucu alabilirsiniz. Spreadsheet sürümü size zaman kazandırır.

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

E-tabloları yeniden adlandırmak, renameSpreadsheet() ürününde yer almak kadar basit. Yalnızca tek bir yöntem çağrısı gerekir.

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 kaydedin ve çalıştırın.

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

Eklenen kodda, setName(name) yöntemi duplicateSheet adının adını değiştirerek e-tablonun benzersiz kimlik numarasını almak için getSheetID() özelliğini kullanır. + operatörü, sayfa kimliğini "Sheet_" dizesinin sonuna birleştirir.

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

E-tablonuzu biçimlendirmek için Sheet sınıfını da kullanabilirsiniz. Örneğin, kopya işlevinizin sütunlarını yeniden boyutlandırmak ve dondurulmuş satırlar eklemek için duplicateAndOrganizeActiveSheet() fonksiyonunuzu 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 kaydedin ve çalıştırın.

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

Eklediğiniz kod, sayfadaki sütunları okunabilirlik açısından yeniden boyutlandırmak için autoResizeColumns(startColumn, numColumns) kullanıyor. setFrozenRows(rows) yöntemi, verilen satır sayısını (bu örnekte iki kez) dondurur. Bu sayede, okuyucu e-tabloyu aşağı kaydırırken başlık satırları görünür durumda kalır.

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

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

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

6. Aralık sınıfıyla verileri yeniden düzenleme

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

Bu bölümde, aralıklarla temel veri işleme açıklanmaktadır. Bu alıştırmalar, Apps Komut Dosyası'ndaki aralıkların nasıl kullanılacağına odaklanmaktadır. Bu oynatma listesindeki diğer codelab'ler ise veri manipülasyonu ve veri biçimlendirmesi konusunda daha fazla ayrıntı verir.

Aralıkları taşı

Veri yöntemlerini, e-tablolardaki belirli hücre kümelerinin tanımlanmasını sağlayan bir kısaltması olan A1 gösterimi ile etkinleştirebilir ve taşıyabilirsiniz. Kendinizi yeniden tanımanız gerekiyorsa bu A1 gösterimi açıklamasına göz atın.

Bazı verileri 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 kaydedin ve çalıştırın.

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

Yeni kod, taşınacak veri aralığını tanımlamak için getRange(a1Notation) yöntemini kullanır. Yöntem parametresi olarak A1 gösterimini "F2:F2" şeklinde girerek F sütununu belirtirsiniz (F1 hariç). Belirtilen aralık varsa getRange(a1Notation) yöntemi Range örneğini döndürür. Kod, kullanımı kolaylaştırmak için örneği myRange değişkeninde depolar.

Aralık tanımlandığında moveTo(target) yöntemi, myRange içeriğinin (hem değerleri hem de biçimlendirmeyi) alır ve bunları taşır. Hedef (C sütunu), A1 gösterimi "C2" kullanılarak belirtilir. Bu bir sütun yerine tek bir hücredir. Verileri taşırken boyutları hedef ve hedef aralıklarıyla eşleştirmeniz gerekmez. Apps Komut Dosyası, her birinin ilk hücresini hizalar.

Not: Kendi komut dosyalarınızı yazarken verilerinizin istediğiniz yere ulaştığından emin olmak için komut dosyalarını ayrıntılı şekilde test edin. Apps Komut Dosyası, hücre değerlerini değiştirirken mevcut veri değerlerinin üzerine yazar. Dikkatli değilseniz, saklamak istediğiniz verilerin üzerine yazabilirsiniz. Bu örnekte C sütunu boştu, ancak veri varsa moveTo(target) yöntemi bunu kaldırır.

Aralıkları sırala

Range sınıfı sayesinde hücre gruplarını okuyabilir, güncelleyebilir ve düzenleyebilirsiniz. Ö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 kaydedin ve çalıştırın.

Şimdi işlev, önceki biçimlendirmemize ek olarak, C sütunundaki fiyat bilgilerini kullanarak tablodaki tüm verileri sıralar:

Yeni kod, A3:D55'i kapsayan yeni bir aralık belirtmek için getRange(a1Notation) özelliğini kullanır (sütun başlıkları hariç tüm tablo). Kod daha sonra tabloyu sıralamak için sort(sortSpecObj) yöntemini çağırır. Burada, sortSpecObj parametresi sıralanacak sütun numarasıdır. Yöntem, belirtilen sütun değerlerinin en düşükten en yükseğe (artan değerler) doğru sıralanacağı şekilde sıralama yapar. sort(sortSpecObj) yöntemi daha karmaşık sıralama koşulları sağlayabilir ancak bunlara ihtiyacınız yoktur. Sıralama aralıklarını çağırmanın tüm farklı yöntemlerini yöntem referansı dokümanlarında görebilirsiniz.

Tebrikler, codelab'deki tüm egzersizleri başarıyla tamamladınız. Sonraki bölümde, bu codelab'in önemli noktaları incelenecek ve bu oynatma listesindeki sonraki codelab'in önizlemesi sunulacaktır.

7. Sonuç

Bu codelab'in sonuna geldiniz. Artık Apps Komut Dosyası'ndaki E-tablo hizmetinin temel sınıflarını ve şartlarını kullanabilir ve tanımlayabilirsiniz.

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

Bu codelab'i faydalı buldunuz mu?

EvetHayır

Ele aldığımız konular

• E-tabloların, e-tabloları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 dizin 0'da başladığı kuralı uygular. Bununla birlikte, satır ve sütunlar 1'den başlayarak dizine eklenir.
2. Apps Komut Dosyası'nda, o anda açık olan sayfa, vurgulanan aralık olan hücre etkin olarak kabul edilir. Birçok Apps Komut Dosyası yöntemi etkin öğeye erişir veya öğeyi değiştirir.
3. Spreadsheet ve Sheet sınıfları, sayfaya özel çeşitli yöntemler paylaşır. Spreadsheet sınıfındaki kopya yöntemler, yalnızca çağrıldıkları sırada etkin sayfayı hedeflediklerinden dolayı yalnızca kullanıcı dostudur.
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. Google E-Tablolar'a giriş bölümünde kimlikler ve URL'ler hakkında daha fazla bilgi edinebilirsiniz.

Temel Şartlar:

• Etkin (durum): Belirtilen e-tablonun, sayfanın, aralığın veya hücrenin, e-tablo kullanıcısının şu anda görüntülemekte ya da vurguladığı sayfa olduğunu belirtir.
• Etkin hücre: Etkin sayfa içinde imleç odağının vurgulandığı tek hücre.
• Etkin aralık: Şu anda etkin sayfada 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 izin vermek için izin verme işlemi veya kullanıcı adına başka bir işlem yapmasına izin verme işlemi.
• Kapsayıcıya bağlı komut dosyası: Google E-Tablosu veya Google Dokümanı gibi bir Google Workspace dokümanına bağlı ve bu komut dosyasından oluşturulan herhangi bir komut dosyası.
• Aralık:** Sayfa içinde yer alan bir veya daha fazla bitişik hücre grubu. Range** sınıfı, bir sayfadaki aralıkları okumanıza ve güncellemenize olanak tanır.
• Komut dosyası düzenleyicisi: Apps Komut Dosyası için tarayıcı içi kod düzenleyici.
• E-tablo**: E-tablonun tek bir sayfası (Microsoft Excel'in çalışma kitabına benzer). Bazen Google Drive'da bir Google E-Tablolar dosyasına başvuruda bulunmak için kullanılır. Sheet** sınıfı, sayfalara erişmenize ve sayfalarda değişiklik yapmanıza olanak tanır.
• SpreadsheetApp: Bu sınıf, E-tablo hizmetinin üst sınıfı görevi görür ve Google E-Tablolar verilerini okuyan veya işleyen 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 e-tablolarda değişiklik yapmanıza olanak tanır.
• E-tablo hizmeti: Komut dosyalarının Google E-Tablolar dosyaları oluşturmasına, bunlara erişmesine ve bu dosyalarda değişiklik yapmasına olanak tanıyan bir Apps Komut Dosyası hizmeti.

Sonraki adımlar

Bu oynatma listesindeki bir sonraki codelab'de, e-tablodaki verileri okuma, yazma ve değiştirme konuları daha ayrıntılı şekilde açıklanmaktadır.

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