Google Sheets API'ye Genel Bakış

Google Sheets API, e-tablolardaki verileri okumanıza ve değiştirmenize olanak tanıyan bir RESTful arayüzüdür. E-Tablolar API'si sayesinde ş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

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

E-tablo

Google E-Tablolar'daki birincil nesne. Her biri Cells içinde yapılandırılmış bilgilere sahip birden çok 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 atıfta bulunan harf, sayı ve bazı özel karakterler içeren belirli bir dizedir ve e-tablonun URL'sinden türetilebilir. E-tablo kimlikleri, e-tablo adı değişse bile 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 parçası olarak benzersiz bir sayısal sheetId değeri ve title sayfası içerir.

Sayfa kimliği
E-tablodaki belirli bir sayfanın benzersiz tanımlayıcısıdır. Bir sayfaya referans veren ve e-tablonun URL'sinden türetilebilecek harf, sayı ve bazı özel karakterler içeren belirli bir dizedir. Sayfa adı değişse bile sayfa kimlikleri sabittir. Örnek için E-tablo kimliği bölümüne bakın.
Hücre

Bir sayfadaki tek bir metin veya veri alanı. Hücreler satır ve sütunlar halinde düzenlenir ve hücre aralığı olarak gruplandırılabilir. Cells kaynağı her bir 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ı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. Bu yöntem, mutlak hücre aralığına referans verirken en yaygın ve kullanışlı yöntemdir.

Örnekleri göster

  • 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, 1. Sayfa'nın ilk sütunundaki 5. satırdan itibaren tüm hücreleri ifade eder.
  • A1:B2, ilk görünür sayfanın ilk iki satır ve sütunundaki tüm hücreleri ifade eder.
  • Sheet1, E-Tablo1'deki tüm hücreleri ifade eder.
  • 'Jon's_Data'!A1:D5, "Can'ın_Verileri" adlı bir sayfanın ilk beş satırındaki ve dört sütunundaki tüm hücreleri ifade eder.
  • 'My Custom Sheet'!A:A, "Özel E-Tablom" adlı bir e-tablonun ilk sütunundaki tüm hücreleri ifade eder.
  • 'My Custom Sheet', "Özel E-Tablom"daki 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.

İpucu: Mümkün olduğunda e-tablonuzdaki nesneler için farklı adlar kullanın. Örneğin, A1 (tırnak işareti olmadan), ilk görünür sayfadaki A1 hücresini belirtir. '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
Bir hücreyi veya hücre aralığını, 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 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 yararlı olabilir.

Örnekleri göster

  • Sheet1!R1C1:R2C2, Sayfa1'in üstteki iki satırındaki ilk iki hücreyi belirtir.
  • R1C1:R2C2, ilk görünür sayfanın en üstteki iki satırındaki ilk iki hücreyi ifade eder.
  • Sheet1!R[3]C[1], geçerli hücrenin üç satır altında ve bir sütun sağında olan hücreyi ifade eder.
Adlandırılmış aralık
Uygulama genelinde referansları 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.