Google Sheets API'ye Genel Bakış

Google Sheets API, bir e-tablodaki verileri okuyup değiştirmenize olanak tanıyan RESTful bir arayüzdür. Bu API'nin en yaygın kullanım alanları arasında aşağıdaki görevler yer alır:

  • E-tablo oluşturma
  • E-tablo hücre değerlerini okuma ve yazma
  • E-tablo biçimlendirmesini güncelle
  • Bağlı Sayfaları yönetme

E-Tablolar API'sinde yaygın olarak kullanılan terimlerin listesini aşağıda bulabilirsiniz:

E-tablo

Google E-Tablolar'da her biri hücrelerde yapılandırılmış bilgilere sahip olan birden fazla sayfa içerebilen birincil nesne. E-tablo kaynağı, her e-tabloyu temsil eder ve harf, sayı, kısa çizgi veya alt çizgiden oluşan benzersiz bir spreadsheetId değerine sahiptir. E-tablo kimliğini bir Google E-Tablolar URL'sinde bulabilirsiniz:

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

E-Tablo

E-tablodaki bir sayfa veya sekme. Sayfa kaynağı, her bir sayfayı temsil eder ve benzersiz bir başlığa ve sayısal sheetId değerine sahiptir. E-tablo kimliğini bir Google E-Tablolar URL'sinde bulabilirsiniz:

https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId

Hücre

Bir sayfadaki bağımsız bir metin veya veri alanı. Hücreler, satırlar ve sütunlar halinde düzenlenir ve hücre aralığı olarak gruplandırılabilir. CellData kaynağı her hücreyi temsil eder ancak benzersiz bir kimlik değerine sahip değildir. Bunun yerine, satır ve sütun koordinatları hücreleri tanımlar.

A1 gösterimi

Bir hücreyi veya hücre aralığını, sayfa adının yanı sıra sütun harfleri ve satır numaralarını kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle tanımlamak için kullanılan söz dizimi. Bu yöntem, mutlak bir hücre aralığına başvururken en yaygın ve kullanışlı olan yöntemdir.

Örnekleri göster

  • Sheet1!A1:B2, Sheet1'in en üstteki iki satırındaki ilk iki hücreye işaret eder.
  • Sheet1!A:A, Sayfa1'in ilk sütunundaki tüm hücrelere başvurur.
  • Sheet1!1:2, Sheet1'in ilk iki satırındaki tüm hücrelere başvurur.
  • Sheet1!A5:A, Sayfa 1'in ilk sütunundaki 5. satırdan başlayarak tüm hücreleri ifade eder.
  • A1:B2, ilk görünür sayfanın en üstündeki iki satırındaki ilk iki hücreye işaret eder.
  • Sheet1, Sayfa1'deki tüm hücrelere başvuruda bulunuyor.
  • 'My Custom Sheet'!A:A, "Özel E-Tablom" adlı bir sayfanın ilk sütunundaki tüm hücrelere yöneliktir. Boşluk, özel karakter veya alfanümerik bir kombinasyon içeren sayfa adları için tek tırnak işareti gerekir.
  • 'My Custom Sheet', "Özel E-Tablom"daki tüm hücrelere başvuruyor.

İpucu: Mümkün olduğunda, e-tablolarınızdaki nesneler için farklı adlar kullanın. Örneğin, A1, görünür ilk sayfadaki A1 hücresini, "A1" ise A1 adlı sayfadaki tüm hücreleri ifade eder. Benzer şekilde, Sayfa1, Sayfa1'deki tüm hücrelere başvuruda bulunur. Ancak, "Sayfa1" başlıklı bir adlandırılmış aralık varsa Sayfa1 adlandırılmış aralığı, "Sayfa1" ise sayfayı belirtir.
R1C1 gösterimi

Bir hücreyi veya hücre aralığını, sayfa adının yanı sıra satır ve sütun numaraları kullanılarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle tanımlamak için kullanılan söz dizimi. Bu yöntem, A1 gösteriminden daha az yaygındır ancak belirli bir hücrenin konumuna göre bir hücre aralığına başvuruda bulunurken yararlı olabilir.

Örnekleri göster

  • Sheet1!R1C1:R2C2, Sheet1'in en üstteki iki satırındaki ilk iki hücreye işaret eder.
  • R1C1:R2C2, ilk görünür sayfanın en üstündeki iki satırındaki ilk iki hücreye işaret eder.
  • Sheet1!R[3]C[1], geçerli hücrenin üç satır altında ve bir sütununda bulunan hücreye işaret eder.
Adlandırılan aralık

Uygulama genelindeki başvuruları basitleştirmek için özel ada sahip tanımlanmış bir hücre veya hücre aralığı. FilterView kaynağı, adlandırılmış bir aralığı temsil eder.

Korunan aralık

Değiştirilemeyen tanımlı bir hücre veya hücre aralığı. ProtectedRange kaynağı, korunan bir aralığı temsil eder.

Sonraki adımlar