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ım alanları ş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

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

E-tablo

Google E-Tablolar'daki her biri birden fazla sayfa içerebilen birincil nesne içeren bir e-posta alırsınız. CEVAP E-tablo kaynağı, her e-tabloyu temsil eder ve bir e-tablo benzersiz 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. CEVAP Sayfa kaynağı, her bir sayfayı temsil eder ve benzersiz bir başlık ve sayısal bir değer sheetId değerini kullanın. 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 şu şekilde düzenlenir: satır ve sütun sayısını gösterir ve bir hücre aralığı olarak gruplandırılabilir. CEVAP CellData kaynağı her bir hücreyi temsil eder ancak benzersiz bir kimlik değerine sahip değildir. Bunun yerine, ve sütun koordinatları da hücreleri tanımlar.

A1 gösterimi

Şu 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 ü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 ifade ederken, "A1" hücresini ifade eder 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ılmış aralık ve "Sayfa1" anlamına gelir. sayfa anlamına gelir.
R1C1 gösterimi

Şu 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 belirli bir hücrenin hücre aralığına göre hücre aralığına referans verirken kullanışlıdır dokunun.

Ö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 ada sahip tanımlanmış bir hücre veya hücre aralığı bir referans noktası görevi görmesidir. CEVAP FilterView kaynağı, adlandırılmış bir aralığı temsil eder.

Korumalı aralık

Değiştirilemeyen, tanımlanmış bir hücre veya hücre aralığı. CEVAP ProtectedRange kaynağı, korunan bir aralığı temsil eder.

Sonraki adımlar