Google Sheets API, e-tablolardaki verileri okumanıza ve değiştirmenize olanak tanıyan RESTful bir arayüzdür. Bu API'nin en yaygın kullanımları aşağıdaki görevleri içerir:
- E-tablo oluşturma
- E-tablo hücre değerlerini okuma ve yazma
- E-tablo biçimlendirmesini güncelle
- Bağlı sayfaları yönetme
Sheets API'de yaygın olarak kullanılan terimlerin listesi aşağıda verilmiştir:
- E-tablo
Google E-Tablolar'daki her biri hücrelerde yapılandırılmış bilgiler içeren birden fazla sayfa içerebilen birincil nesnedir. E-tablo kaynağı her e-tabloyu temsil eder ve harf, sayı, kısa çizgi veya alt çizgi içeren benzersiz bir
spreadsheetId
değerine sahiptir. E-tablo kimliğini Google E-Tablolar URL'sinde bulabilirsiniz:https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0
- Sayfa
E-tablodaki bir sayfa veya sekme. Sayfa kaynağı, her bir sayfayı temsil eder ve benzersiz bir başlık ile sayısal
sheetId
değerine sahiptir. Sayfa kimliğini Google E-Tablolar URL'sinde bulabilirsiniz:https://docs.google.com/spreadsheets/d/aBC-123_xYz/edit#gid=sheetId
- Hücre
Bir sayfa içindeki tek bir metin veya veri alanı. Hücreler, satır ve sütunlar halinde düzenlenir ve bir hücre aralığı olarak gruplandırılabilir. CellData kaynağı, her bir 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
Sayfa adının yanı sıra sütun harfleri ve satır numaraları kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle bir hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi. Mutlak hücre aralığına başvururken en yaygın ve yararlı olan bu yöntemdir.
Örnekleri göster
Sheet1!A1:B2
, Sayfa1'in üstteki iki satırındaki ilk iki hücreyi belirtir.Sheet1!A:A
, Sayfa1'in ilk sütunundaki tüm hücreleri ifade eder.Sheet1!1:2
, Sayfa1'in ilk iki satırındaki tüm hücreleri ifade eder.Sheet1!A5:A
, Sayfa 1'in ilk sütunundaki, 5. satırdan sonraki tüm hücreleri ifade eder.A1:B2
, görünür durumdaki ilk sayfanın ilk iki satırındaki ilk iki hücreyi belirtir.Sheet1
, Sayfa1'deki tüm hücreleri ifade eder.'My Custom Sheet'!A:A
, "Özel Sayfam" adlı bir sayfanın ilk sütunundaki tüm hücreleri ifade eder. Boşluk, özel karakter veya alfanümerik kombinasyon içeren sayfa adları için tek tırnak işareti gereklidir.'My Custom Sheet'
, "Özel Sayfam"daki tüm hücreleri ifade eder.
İpucu: E-tablolarınızdaki nesneler için mümkünse farklı adlar kullanın. Örneğin, A1 görünür ilk sayfadaki A1 hücresini, "A1" ise A1 adlı bir sayfadaki tüm hücreleri ifade eder. Benzer şekilde, Sayfa1, Sayfa1'deki tüm hücreleri ifade eder. Ancak "Sayfa1" başlıklı bir adlandırılmış aralık varsa Sayfa1, adlandırılan aralığı, "Sayfa1" ise sayfayı ifade eder.
- R1C1 gösterimi
Sayfa adını ve satır numaralarını ve sütun numaralarını kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle bir hücreyi veya hücre aralığını 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 referans verirken faydalı olabilir.
Örnekleri göster
Sheet1!R1C1:R2C2
, Sayfa1'in üstteki iki satırındaki ilk iki hücreyi belirtir.R1C1:R2C2
, görünür durumdaki ilk sayfanın ilk iki satırındaki ilk iki hücreyi belirtir.Sheet1!R[3]C[1]
, geçerli hücrenin üç satır altında ve bir sütun sağ tarafında bulunan hücreyi belirtir.
- Adlandırılmış aralık
Bir uygulama genelinde başvuruları basitleştirmek için özel bir ada sahip tanımlanmış bir hücre veya hücre aralığı. FilterView kaynağı, adlandırılmış bir aralığı temsil eder.
- Korumalı aralık
Değiştirilemeyen, tanımlanmış 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 Sheets 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.