Bu bölümde, Google Sheets API'yi tanımak için kullanabileceğiniz bir codelab sunulmaktadır. Ayrıca, amaçlanan bir Google E-Tablolar işleminin nasıl API isteğine dönüştürüleceğini gösteren bir dizi "reçete" örneği de sağlanır.
Genellikle API ile belirli bir görevi tamamlamanın 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. Birincisinin arayüzü, basit okuma/yazma işlemleri için daha kolay kullanılır. Mümkün olan her yerde, birden fazla isteği tek bir yöntem çağrısında paketlemek için toplu yöntemleri (
spreadsheet.batchUpdate,spreadsheet.values.batchGetvespreadsheet.values.batchUpdate) kullanın. Bu toplu yöntemlerin kullanılması, aşağıdaki nedenlerden dolayı verimliliği artırır:- İstemci HTTP ek yükünü azaltın.
- Yapılan sorgu sayısını azaltın.
- Dokümandaki 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 örnekler, Sheets'teki yaygın işlemlerin Sheets API v4 istekleri olarak nasıl ifade edileceğini gösterir.
Bu örnekler, dilden bağımsız olması için HTTP istekleri şeklinde sunulur. Google API istemci kitaplıklarını kullanarak belirli bir dilde E-Tablolar API istek protokollerini nasıl uygulayacağınızı öğrenmek için Hücre değerlerini okuma ve yazma ile 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: Değerlerin bir sayfaya nasıl yazılacağını gösteren tarifler.
- Temel biçimlendirme: Sayfaların ve hücrelerin görünümünü değiştirmeyi gösteren tarifler.
- Grafikler: Bir sayfada grafiklerin nasıl oluşturulacağını ve değiştirileceğini gösteren tarifler.
- Koşullu biçimlendirme: Hücre görünümünü koşullara göre değiştirme yöntemlerini 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 korumalı aralıklar: E-tabloda adlandırılmış ve korumalı aralıkların nasıl oluşturulacağını, güncelleneceğini ve kaldırılacağını gösteren formüller.
- 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ı oluşturma, temizleme, kopyalama ve silmenin yanı sıra özelliklerini kontrol etme yöntemlerini gösteren tarifler.