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.valueskoleksiyonu,spreadsheetskoleksiyonundan 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.batchGetvespreadsheet.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: Bir sayfadaki değerlerin nasıl okunacağını gösteren tarifler.
- Temel yazma: Bir sayfaya değer yazmayı 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şturmayı ve değiştirmeyi gösteren tarifler.
- Koşullu biçimlendirme: Hücre görünümünü koşullara göre nasıl değiştireceğinizi 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 aralıkları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 eklemeyi, kaldırmayı, taşımayı ve bunların özelliklerini güncellemeyi gösteren tarifler.
- Sayfa işlemleri: Sayfa oluşturma, temizleme, kopyalama ve silme işlemlerinin yanı sıra sayfa özelliklerini kontrol etme işlemlerini gösteren tarifler.