Google Sheets API'ye Genel Bakış

Google Sheets API, bir sayfayı okumanıza ve değiştirmenize olanak tanıyan e-tablo verileri. Bu API'nin en yaygın kullanımları şunlardır: görevler:

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

Aşağıda, bu API'de kullanılan genel terimlerin listesi yer almaktadır:

E-tablo

Google E-Tablolar'daki her biri birden fazla sayfa içerebilen birincil nesne içeren bir e-posta alırsınız. Spreadsheet source her şeyi temsil eder ve benzersiz bir özelliğe spreadsheetId değeri, Harf, sayı, kısa çizgi veya alt çizgi içermelidir. Daha fazla Google E-Tablolar URL'sindeki e-tablo kimliği:

https://docs.google.com/spreadsheets/d/spreadsheetId/edit#gid=0

Sayfa

E-tablodaki bir sayfa veya sekme. Sheet source her birini temsil eder benzersiz bir başlığı ve sayısal değeri var sheetId değeri. Siz sayfa kimliğini Google E-Tablolar URL'sinde bulabilir:

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ırlar halinde düzenlenir ve sütunlar şeklinde gruplanabilir. Bir hücre aralığı olarak gruplandırılabilir. CellData source her birini temsil eder ancak benzersiz bir kimlik değerine sahip değildir. Bunun yerine koordinatlar hücreleri tanımlar.

A1 gösterimi
Aşağıdakileri içeren bir dizeyi içeren bir hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi: sayfa adı ile birlikte başlangıç ve bitiş hücre koordinatlarını içeren sütun harfleri ve satır numaraları. Bu yöntem, en yaygın ve en faydalı yöntemdir mutlak bir hücre aralığına başvururken de aynı oranda etkilidir.

Ö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, Sayfa 1'in ilk sütunundaki, 5. satırdan sonraki tüm hücreleri ifade eder.
  • A1:B2, görünür ilk sayfanın ilk iki satırı ve sütunundaki tüm hücreleri ifade eder.
  • Sheet1, Sayfa1'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 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, özel karakter veya alfanümerik kombinasyon içeren sayfa adları için tek tırnak işareti gereklidir.

İ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, Sheet1, 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ığı, Sheet1 ise sayfayı ifade eder.

R1C1 gösterimi
Aşağıdakileri içeren bir dizeyi içeren bir hücreyi veya hücre aralığını tanımlamak için kullanılan söz dizimi: sayfa adı ile birlikte başlangıç ve bitiş hücre koordinatlarını içeren satır numaralarını ve sütun numaralarını yazın. Bu yöntem, A1 gösteriminden daha az yaygındır. Ancak bu özellik, belirli bir hücreye göre bir hücre aralığına referans verirken hücrenin konumuna.

Ö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
Basitleştirmek için özel bir ada sahip tanımlanmış bir hücre veya hücre aralığı bir referans noktası görevi görmesidir. FilterView kaynak adlandırılmış bir aralığı temsil eder.
Korumalı aralık
Değiştirilemeyen, tanımlanmış bir hücre veya hücre aralığı. CEVAP ProtectedRange kaynak korunan bir aralığı temsil eder.