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
Kimlik doğrulama ve yetkilendirmeyi yönetme de dahil olmak üzere Google Workspace API'leriyle geliştirme hakkında bilgi edinmek için Google Workspace'te Geliştirme bölümüne bakın.
Basit bir E-Tablolar API uygulamasını nasıl yapılandırıp çalıştıracağınızı öğrenmek için Hızlı başlangıç kılavuzlarına genel bakış makalesini okuyun.