Google Sheets API'ye Genel Bakış

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