Bu bölümde, Google E-Tablolar API'sine aşina olmak için kullanabileceğiniz bir codelab sunulmaktadır. Ayrıca, istenen bir Google E-Tablolar işleminin API isteğine nasıl çevrileceğini gösteren bir dizi "reçete" örneği de sağlanmıştır.
API ile belirli bir görevi tamamlamanın genellikle birden fazla yolu vardır. Bir göreve nasıl yaklaşacağınıza karar verirken aşağıdakileri göz önünde bulundurun:
- Hücre değerlerini okumanız veya yazmanız gerekiyorsa
spreadsheets.values
koleksiyonu,spreadsheets
koleksiyonundan daha iyi bir seçimdir. İlkinin arayüzü, basit okuma/yazma işlemleri için daha kolaydır. Mümkün olduğunda, birden fazla isteği tek bir yöntem çağrısında toplamak için toplu yöntemleri (
spreadsheet.batchUpdate
,spreadsheet.values.batchGet
vespreadsheet.values.batchUpdate
) kullanın. Bu toplu yöntemler, aşağıdaki nedenlerle verimliliği artırır:- İstemci HTTP ek yükünü azaltın.
- Yapılan sorgu sayısını azaltın.
- Dokümanda düzeltme sayısını azaltın.
- Toplu işlemdeki tüm değişikliklerin atomik olduğundan emin olun.
Yemek tarifleri
Bu bölümde listelenen örneklerde, Sheets'teki yaygın işlemlerin Sheets API v4 istekleri olarak nasıl ifade edileceği gösterilmektedir.
Bu örnekler, dil açısından tarafsız olması için HTTP istekleri biçiminde sunulur. Google API istemci kitaplıklarını kullanarak E-Tablolar API istek protokollerini belirli bir dilde nasıl uygulayacağınızı öğrenmek için Hücre değerlerini okuma ve yazma ve E-tabloları güncelleme kılavuzlarına bakın.
Bu bölümdeki tarifler aşağıdaki kategorilere ayrılmıştır:
- Temel okuma: E-tablodaki değerlerin nasıl okunacağını gösteren tarifler.
- Temel yazma: Bir sayfaya nasıl değer yazılacağını gösteren tarifler.
- Temel biçimlendirme: E-tabloların ve hücrelerin görünümünün nasıl değiştirileceğini gösteren tarifler.
- Grafikler: Bir e-tabloda grafik oluşturma ve değiştirme işlemlerini gösteren tarifler.
- Koşullu biçimlendirme: Koşullara göre hücre görünümünün nasıl değiştirileceğini gösteren tarifler.
- Veri işlemleri: E-tabloda verilerin nasıl oluşturulacağını, taşınacağını ve işleneceğini gösteren tarifler.
- Adlandırılmış ve korunan aralıklar: E-tablolarda adlandırılmış ve korunan alanların nasıl oluşturulacağını, güncelleneceğini ve kaldırılacağını gösteren tarifler.
- Pivot tablolar: Bir sayfada pivot tabloların nasıl oluşturulacağını gösteren tarifler.
- Satır ve sütun işlemleri: Satır ve sütun ekleme, kaldırma, taşıma ve özelliklerini güncelleme işlemlerini gösteren tarifler.
- Sayfa işlemleri: Sayfaların nasıl oluşturulacağını, temizleneceğini, kopyalanacağını ve silineceğini ve ayrıca özelliklerinin nasıl kontrol edileceğini gösteren tarifler.