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 olduğunda, 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öntemler, aşağıdaki avantajları sayesinde 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, dil açısından tarafsı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ün koşullara göre nasıl değiştirileceğini gösteren tarifler.
- Veri işlemleri: E-tabloda veri oluşturma, taşıma ve verileri işleme yöntemlerini 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 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.
- E-tablo işlemleri: E-tabloları oluşturma, temizleme, kopyalama ve silmenin yanı sıra özelliklerini kontrol etme hakkında bilgi veren tarifler.