Google Sheets API'ye Genel Bakış

5 dakikanız var mı?
Kısa bir online ankete katılarak Google Workspace dokümanlarımızı iyileştirmemize yardımcı olun.

Google Sheets API, e-tablolardaki verileri okumanıza ve değiştirmenize olanak tanıyan bir RESTful arayüzüdür. Sheets API ile şunları yapabilirsiniz:

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

Aşağıda, Sheets API'de kullanılan yaygın terimlerin listesi verilmiştir:

E-tablo

Google E-Tablolar'daki birincil nesne. Her biri Cells içinde yapılandırılmış bilgiler içeren birden fazla Sheets içerebilir. spreadsheets kaynağı, bir e-tabloyu temsil eder. Benzersiz bir spreadsheetId değeri içerir.

E-tablo kimliği
E-tablonun benzersiz tanımlayıcısı. E-tabloya referans veren harfler, sayılar ve bazı özel karakterler içeren belirli bir dizedir ve e-tablonun URL'sinden türetilebilir. E-tablo adı değişse bile e-tablo kimlikleri sabit kalır.
https://docs.google.com/spreadsheets/d/SPREADSHEET_ID/edit?gid=SHEET_ID#gid=SHEET_ID
Sayfa

E-tablodaki bir sayfa veya sekme. Sheets kaynağı bir sayfayı temsil eder. SheetProperties nesnesinin bir parçası olarak benzersiz bir sayısal sheetId değeri ve sayfa title içerir.

Sayfa kimliği
E-tablodaki belirli bir sayfanın benzersiz tanımlayıcısı. Bir sayfaya referans veren sayıları içeren belirli bir tam sayıdır ve e-tablonun URL'sinden elde edilebilir. Sayfa adı değişse bile sayfa kimlikleri sabit kalır. Örnek için E-tablo kimliği başlıklı makaleye bakın.
Hücre

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

A1 gösterimi
Sayfa adını ve sütun harfleri ile satır numaralarını kullanarak başlangıç ve bitiş hücre koordinatlarını içeren bir dizeyle hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi. Bu yöntem, mutlak bir hücre aralığına başvururken en yaygın ve faydalı olanıdır.
  • Sheet1!A1:B2, Sayfa1'in ilk iki satır ve sütunundaki tüm hücreleri ifade eder.
  • 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, Sayfa1'in ilk sütunundaki 5. satırdan itibaren tüm hücreleri ifade eder.
  • A1:B2, ilk görünür sayfadaki ilk iki satır ve sütundaki tüm hücreleri ifade eder.
  • Sheet1, Sayfa1'deki tüm hücreleri ifade eder.
  • 'Jon's_Data'!A1:D5, "Jon's_Data" adlı bir sayfadaki ilk beş satır ve dört sütundaki 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.
  • 'My Custom Sheet', "Özel Sayfam"daki tüm hücreleri ifade eder.

Boşluk veya özel karakter içeren sayfa adları için tek tırnak işareti gerekir.

İpucu: Mümkün olduğunda, e-tablolarınızdaki nesneler için farklı adlar kullanın. Örneğin, A1 (tırnak işareti olmadan) ilk görünür sayfadaki A1 hücresini ifade eder. 'A1', A1 adlı bir sayfayı ifade eder. Benzer şekilde, Sayfa1, Sayfa1 adlı bir sayfayı ifade eder. Ancak "Sayfa1" adlı bir adlandırılmış aralık varsa Sayfa1, adlandırılmış aralığı, 'Sheet1' ise sayfayı ifade eder.

R1C1 gösterimi
Sayfa adını ve satır numaraları ile 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 kullanılır ancak belirli bir hücrenin konumuna göre bir hücre aralığına referans verirken faydalı olabilir.
  • Sheet1!R1C1:R2C2, Sayfa1'in en üstteki iki satırındaki ilk iki hücreyi ifade eder.
  • R1C1:R2C2, ilk görünür sayfadaki ilk iki satırın ilk iki hücresini ifade eder.
  • Sheet1!R[3]C[1], geçerli hücrenin üç satır altında ve bir sütun sağındaki hücreyi ifade eder.
Adlandırılmış aralık
Bir uygulama genelinde referansları basitleştirmek için özel bir ada sahip tanımlanmış bir hücre veya hücre aralığı. A FilterView kaynağı, adlandırılmış bir aralığı temsil eder.
Korumalı aralık
Değiştirilemeyen tanımlı bir hücre veya hücre aralığı. A ProtectedRange kaynağı, korumalı bir aralığı temsil eder.