Örnekler
Koleksiyonlar ile düzeninizi koruyun
İçeriği tercihlerinize göre kaydedin ve kategorilere ayırın.
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.values
koleksiyonu, spreadsheets
koleksiyonundan 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.batchGet ve spreadsheet.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.
Aksi belirtilmediği sürece bu sayfanın içeriği Creative Commons Atıf 4.0 Lisansı altında ve kod örnekleri Apache 2.0 Lisansı altında lisanslanmıştır. Ayrıntılı bilgi için Google Developers Site Politikaları'na göz atın. Java, Oracle ve/veya satış ortaklarının tescilli ticari markasıdır.
Son güncelleme tarihi: 2025-08-29 UTC.
[null,null,["Son güncelleme tarihi: 2025-08-29 UTC."],[],[],null,["# Samples\n\nThis section presents a\n[codelab](https://codelabs.developers.google.com/codelabs/sheets-api/) you can\nuse to become familiar with the Google Sheets API. Also provided are a set of\n\"recipe\" examples that demonstrate how to translate an intended Google Sheets\naction into an API request.\n\nOften there's more than one way to complete a given task with the API. When\nyou're deciding on how to approach a task, keep the following in mind:\n\n- If you need to read or write cell values, the [`spreadsheets.values`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values) collection is a better choice than the [`spreadsheets`](/workspace/sheets/api/reference/rest/v4/spreadsheets) collection. The former's interface is easier to use for simple read/write operations.\n- Wherever possible, use the batch methods\n ([`spreadsheet.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets/batchUpdate),\n [`spreadsheet.values.batchGet`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchGet),\n and\n [`spreadsheet.values.batchUpdate`](/workspace/sheets/api/reference/rest/v4/spreadsheets.values/batchUpdate))\n to bundle multiple requests into a single method call. Using these batch\n methods improves efficiency as they:\n\n - Reduce client HTTP overhead.\n - Reduce the number of queries made.\n - Reduce the number of revisions on the doc.\n - Ensure atomicity of all the changes in the batch.\n\nRecipes\n-------\n\nThe examples listed in this section demonstrate how to express common actions in\nSheets as Sheets API v4 requests.\n\nThese examples are presented in the form of HTTP requests to be language\nneutral. To learn how to implement Sheets API request protocols in a\nspecific language using Google API client libraries, see the [Read \\& write cell\nvalues](/workspace/sheets/api/guides/values) and [Update\nspreadsheets](/workspace/sheets/api/guides/batchupdate) guides.\n\nRecipes in this section are divided into the following categories:\n\n- [Basic reading](/workspace/sheets/api/samples/reading)---Recipes that show how to read values from a sheet.\n- [Basic writing](/workspace/sheets/api/samples/writing)---Recipes that show how to write values to a sheet.\n- [Basic formatting](/workspace/sheets/api/samples/formatting)---Recipes that show how to change the appearance of sheets and cells.\n- [Charts](/workspace/sheets/api/samples/charts)---Recipes that show how to create and alter charts in a sheet.\n- [Conditional formatting](/workspace/sheets/api/samples/conditional-formatting)--- Recipes that show how to alter cell appearance based on conditions.\n- [Data operations](/workspace/sheets/api/samples/data)---Recipes that show how to create, move, and manipulate data in a spreadsheet.\n- [Named \\& protected\n ranges](/workspace/sheets/api/samples/ranges)---Recipes that show how to create, update, and remove named and protected ranges in a spreadsheet.\n- [Pivot tables](/workspace/sheets/api/samples/pivot-tables)---Recipes that show how to create pivot tables in a sheet.\n- [Row \\& column\n operations](/workspace/sheets/api/samples/rowcolumn)---Recipes that show how to add, remove, and move rows and columns, and update their properties.\n- [Sheet operations](/workspace/sheets/api/samples/sheet)---Recipes that show how to create, clear, copy, and delete sheets, and also control their properties."]]
