Sheets API v3'ten veri taşıma

v3 API

Sheets API v3, tek bir yetkilendirme kapsamıyla çalışır:

https://spreadsheets.google.com/feeds

şununla aynı anlama gelir:

https://www.googleapis.com/auth/spreadsheets

Her iki kapsam biçimi de kullanılabilir.

v4 API

E-Tablolar API'si v4, aşağıdaki kapsam gruplarından birini veya daha fazlasını kullanır:

https://www.googleapis.com/auth/spreadsheets.readonly
https://www.googleapis.com/auth/spreadsheets
https://www.googleapis.com/auth/drive.readonly
https://www.googleapis.com/auth/drive

Uygulamanızın bir kullanıcının e-tablolarında veya e-tablo özelliklerinde düzenleme yapması gerekmiyorsa salt okuma kapsamlarını kullanın. Uygulamanın genel Drive erişimine ihtiyacı yoksa Drive kapsamları yerine e-tablo kapsamları kullanın.

v3 API

E-Tablolar API'si v3, görünürlüğü doğrudan uç noktalarında ifade eder. public e-tabloları "Web'de yayınlanmıştır" ve bu nedenle API tarafından yetkilendirme olmadan erişilebilir. private e-tabloları için ise kimlik doğrulama gerekir. Görünürlük, uç noktada e-tablo kimliğinden sonra belirtilir:

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

v4 API

Yeni E-Tablolar API v4'te görünürlüğü açıkça beyan etme seçeneği yoktur. API çağrıları, e-tablo kimlikleri kullanılarak yapılır. Uygulamanın belirtilen e-tabloya erişme izni yoksa hata döndürülür. Aksi takdirde görüşme devam eder.

v3 API

E-Tablolar API v3'te yalnızca iki olası projeksiyon ayarı vardır. fullprojeksiyonu mevcut tüm bilgileri döndürür. basic ise daha küçük ve sabit bir veri alt kümesi döndürür (çalışma sayfaları, liste ve hücre feed'leri için). Görünürlük gibi projeksiyon da API uç noktasında (görünürlük ayarından sonra) belirtilmelidir:

https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/public/basic

basic projeksiyonu tarafından sağlanan daha küçük veri alt kümesi, kodu daha verimli hale getirmek için değerlidir ancak özelleştirilemez.

v4 API

E-Tablolar API'si v4 tam bir veri kümesi döndürebilir ancak E-Tablolar API'si v3'teki basic görünürlük ayarına benzer sabit alt kümeler tanımlamaz. E-tablo koleksiyonundaki yöntemler, fields sorgu parametresini kullanarak döndürdükleri veri miktarını kısıtlar.

Örneğin, aşağıdaki sorgu yalnızca belirli bir e-tablodaki tüm sayfaların başlıklarını döndürür:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?fields=sheets.properties.title

v3 API

Sheets API v3, yeni e-tablo oluşturma yöntemi sunmaz. Bunun yerine, yeni e-tablo dosyaları oluşturmak için Drive API Files.create yöntemi kullanılabilir. Bunun için uygulamanın https://www.googleapis.com/auth/drive kapsamını belirtmesi gerekir.

v4 API

Drive API Files.create yöntemi, Sheets API v4 ile de kullanılabilir ancak uygulamanın https://www.googleapis.com/auth/drive kapsamını sağlaması gerekir.

Eşdeğer bir alternatif olarak E-Tablolar API v4, isteğe bağlı olarak e-tablo ekleyebilen, e-tablo ve e-tablo özelliklerini ayarlayabilen ve adlandırılmış aralıklar ekleyebilen bir spreadsheets.create yöntemi sağlar. Örneğin, aşağıdaki komut yeni bir e-tablo oluşturur ve bu e-tabloya "YeniBaşlık" adını verir:

POST https://sheets.googleapis.com/v4/spreadsheets

{
 "properties": {"title": "NewTitle"}
}

v3 API

Sheets API v3 feed'i, bir uygulamanın kimliği doğrulanmış kullanıcının erişebildiği tüm e-tabloların listesini almasına olanak tanır. E-tablo feed'i uç noktası:

GET https://spreadsheets.google.com/feeds/spreadsheets/private/full

v4 API

Sheets API v4 bu işlemi sağlamaz. Uygulamanızı, e-tablo seçimi için Google Seçici ile birlikte drive.file kapsamını kullanacak şekilde taşımanızı öneririz.

E-tabloları listelemenin gerekli olduğu durumlarda, mimeType sorgusu kullanılarak Drive API Files.list yöntemi aracılığıyla bu işlem tekrarlanabilir:

GET https://www.googleapis.com/drive/v3/files
             ?q=mimeType='application/vnd.google-apps.spreadsheet'

Bir kullanıcının tüm e-tablolarını listelemek için Drive API files.list yöntemini kullanmak kısıtlı bir kapsam gerektirir.

v3 API

E-tablo feed'ine bu API uç noktasından (uygun bir yetkilendirme başlığı kullanılarak) erişilebilir:

GET https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

Bu istek için verilen yanıt, her sayfanın verilerinin ayrı bir <entry> içinde bulunduğu şuna benzer bir yapıya sahiptir:

<feed xmlns="http://www.w3.org/2005/Atom"
    xmlns:openSearch="http://a9.com/-/spec/opensearch/1.1/"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006"
    xmlns:gd="http://schemas.google.com/g/2005"
    gd:etag='W/"D0cERnk-eip7ImA9WBBXGEg."'>
  <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <title type="text">Groceries R Us</title>
  <link rel="alternate" type="text/html"
      href="https://spreadsheets.google.com/ccc?key=spreadsheetId"/>
  <link rel="http://schemas.google.com/g/2005#feed"
      type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <link rel="http://schemas.google.com/g/2005#post" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full"/>
  <author>
    <name>Fitzwilliam Darcy</name>
    <email>fitz@example.com</email>
  </author>
  <openSearch:totalResults>1</openSearch:totalResults>
  <openSearch:startIndex>1</openSearch:startIndex>
  <openSearch:itemsPerPage>1</openSearch:itemsPerPage>
  <entry gd:etag='"YDwqeyI."'>
    <id>https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId</id>
    <updated>2006-11-17T18:23:45.173Z</updated>
    <title type="text">Sheet1</title>
    <content type="text">Sheet1</content>
    <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
    <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
        type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
    <link rel="self" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
    <link rel="edit" type="application/atom+xml"
        href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
    <gs:rowCount>100</gs:rowCount>
    <gs:colCount>20</gs:colCount>
  </entry>
</feed>

v4 API

spreadsheets.get yöntemi, e-tablo özelliklerini ve diğer meta verileri almak için kullanılabilir. Bu yöntem, Sheets API v3'ün sunduğundan çok daha fazlasını sunar. Yalnızca sayfa özelliklerini okumak istiyorsanız e-tablo hücre verilerinin dahil edilmesini önlemek için includeGridData sorgu parametresini false olarak ayarlayın:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId?includeGridData=false

Spreadsheet yanıtı bir Sheet nesnesi dizisi içerir. Özellikle sayfa başlıkları ve boyut bilgileri bu nesnelerin SheetProperties öğesinin altında bulunabilir. Örneğin:

{
  "spreadsheetId": spreadsheetId,
  "sheets": [
      {"properties": {
          "sheetId": sheetId,
          "title": "Sheet1",
          "index": 0,
          "gridProperties": {
              "rowCount": 100,
              "columnCount": 20,
              "frozenRowCount": 1,
              "frozenColumnCount": 0,
              "hideGridlines": false
          },
          ...
       },
       ...
      },
      ...
  ],
  ...
}

v3 API

Sheets API v3, aşağıdaki (kimliği doğrulanmış) POST isteğini göndererek e-tabloya yeni çalışma sayfaları ekleyebilir. Yeni sayfanın boyutunu belirtebilirsiniz:

POST https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <title>Expenses</title>
  <gs:rowCount>50</gs:rowCount>
  <gs:colCount>10</gs:colCount>
</entry>

v4 API

spreadsheets.batchUpdate yönteminde AddSheet isteği göndererek yeni e-tablolar ekleyebilirsiniz. İstek gövdesi kapsamında, yeni sayfanın sayfa özelliklerini belirtebilirsiniz. Tüm özellikler isteğe bağlıdır. Mevcut bir sayfa için kullanılan bir başlık sağlamak hatalıdır.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [{
      "addSheet": {
          "properties": {
            "title": "Expenses",
            "sheetType": "GRID",
            "gridProperties": {
              "rowCount": 50,
              "columnCount": 10
            }
          }
      }
  }],
}

v3 API

Bir çalışma sayfasının başlığını veya boyutunu değiştirmek için çalışma sayfası feed'ini alarak ve edit URL'si içeren istediğiniz çalışma sayfası girişini bularak başlayın. E-tablonun meta verilerini güncelleyin ve düzenleme URL'sine bir PUT isteği gövdesi olarak gönderin. Örneğin:

PUT https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

<entry>
  <id>
    https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId
  </id>
  <updated>2007-07-30T18:51:30.666Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#worksheet"/>
  <title type="text">Expenses</title>
  <content type="text">Expenses</content>
  <link rel="http://schemas.google.com/spreadsheets/2006#listfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full"/>
  <link rel="http://schemas.google.com/spreadsheets/2006#cellsfeed"
    type="application/atom+xml" href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full"/>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version"/>
  <gs:rowCount>45</gs:rowCount>
  <gs:colCount>15</gs:colCount>
</entry>

v4 API

E-tablonun boyutunu, başlığını ve diğer özelliklerini güncellemek için spreadsheets.batchUpdate yönteminde updateSheetProperties isteği gönderin. POST istek gövdesi, değiştirilecek özellikleri içermeli ve fields parametresi bu özellikleri açıkça listelemelidir (tüm mülkleri güncellemek istiyorsanız hepsini listelemek için kısayol olarak fields:"*" kullanın). Örneğin, aşağıdaki kodda, belirli bir kimliğe sahip sayfanın başlık ve boyut özelliklerinin güncellenmesi gerektiği belirtilmektedir:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "updateSheetProperties": {
          "properties": {
            "sheetId": sheetId,
            "title": "Expenses",
            "gridProperties": {
              "rowCount": 45,
              "columnCount": 15,
            }
          },
          "fields": "title,gridProperties(rowCount,columnCount)"
     }
   }
  ],
}

Bir sayfanın sheetId değerini almak için e-tablo spreadsheets.get yöntemini kullanın.

v3 API

Bir çalışma sayfasını silmek için çalışma sayfası feed'ini alarak başlayın, ardından hedef çalışma sayfası girişinin edit URL'sinde bir DELETE isteği gönderin.

DELETE https://spreadsheets.google.com/feeds/worksheets/spreadsheetId/private/full/sheetId/version

v4 API

Bir sayfayı silmek için spreadsheets.batchUpdate yönteminde DeleteSheet isteği gönderin. POST istek metni, sayfanın silinmesi için yalnızca sheetId öğesini içermelidir. Örneğin:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteSheet": {
        "sheetId": sheetId
      }
    }
  ],
}

Bir sayfanın sheetId değerini almak için e-tablo spreadsheets.get yöntemini kullanın.

v3 API

Belirli bir çalışma sayfası için liste tabanlı bir feed'in URL'sini belirlemek üzere çalışma sayfası feed'ini alın ve ilgilendiğiniz çalışma sayfası girişinde liste feed'i URL'sini bulun.

Liste tabanlı bir feed almak için uygun bir yetkilendirme üstbilgisi kullanarak liste feed'i URL'sine bir GET isteği gönderin. Örneğin:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

Bu isteğe verilen yanıtta, diğer öğelerin yanı sıra belirli satırlara karşılık gelen girişler bulunur. Bağımsız hücrelere, (zorunlu) sayfa başlık satırında sağlanan adlarla referans verilir. Örneğin, tek satırlık bir giriş aşağıda verilmiştir:

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
      term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>10</gsx:hours>
  <gsx:items>2</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

Liste feed'inde döndürülen satırlar varsayılan olarak satır sırasına göre döndürülür. E-Tablolar API'si v3, bu sırayı değiştirmek için sorgu parametreleri sağlar.

Ters sıra:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full?reverse=true

Belirli bir sütuna göre sıralama:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?orderby=column:lastname

E-Tablolar API'si v3, yapılandırılmış sorgu (sütun başlıklarıyla referans verilen) aracılığıyla belirli satırların filtrelenmesine de olanak tanır:

GET https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full
             ?sq=age>25%20and%20height<175

v4 API

Sheets API v4 ile spreadsheets.values.get veya spreadsheets.values.batchGet yöntemleri kullanılarak satırlar aralığa göre alınabilir. Örneğin, aşağıdaki ifade "Sayfa1"daki tüm satırları döndürür:

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1

Bu isteğe verilen yanıtın yapısı şuna benzer:

{
  "range": "Sheet1",
  "majorDimension": "ROWS",
  "values": [["Name", "Hours", "Items", "IPM"],
             ["Bingley", "10", "2", "0.0033"],
             ["Darcy", "14", "6", "0.0071"]]
}

Satırların, sütunların veya sayfaların tamamı alınırken sonundaki boş hücreler yanıta dahil edilmez.

Sheets API v4, Sheets API v3 tarafından sağlanan satır sırası sorgu parametrelerinin eşdeğerlerine sahip değildir. Ters sıra basittir; döndürülen values dizisini ters sırada işlemeniz yeterlidir. Okuma işlemleri için sütuna göre sıralama desteklenmez ancak e-tablodaki verileri (SortRange isteği kullanılarak) sıralayıp okumak mümkündür.

Sheets API v4'te şu anda Sheets API v3 yapılandırılmış sorguları için doğrudan bir eşdeğer yoktur. Ancak uygulamanızda ilgili verileri alıp gerektiği gibi sıralayabilirsiniz.

v3 API

Belirli bir çalışma sayfası için liste tabanlı bir feed'in URL'sini belirlemek üzere çalışma sayfası feed'ini alın ve ilgili çalışma sayfası girişinde yayın URL'sini bulun.

Veri satırı eklemek için uygun bir yetkilendirme üstbilgisini kullanarak gönder URL'sine bir POST isteği gönderin. Örneğin:

POST https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full

POST isteğinin gövdesinde, sütun başlıklarına göre referans verilen bağımsız hücrelerle birlikte eklenecek satır verileri için bir giriş bulunmalıdır:

<entry xmlns="http://www.w3.org/2005/Atom"
       xmlns:gsx="http://schemas.google.com/spreadsheets/2006/extended">
  <gsx:hours>2</gsx:hours>
  <gsx:ipm>0.5</gsx:ipm>
  <gsx:items>60</gsx:items>
  <gsx:name>Elizabeth</gsx:name>
</entry>

Yeni satırlar, belirtilen sayfanın sonuna eklenir.

v4 API

Sheets API v4 ile spreadsheets.values.append yöntemini kullanarak satır ekleyebilirsiniz. Aşağıdaki örnekte, bir e-tablonun "Sayfa1" bölümündeki son tablonun altına yeni bir veri satırı yazılıyor.

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/append/Sheet1

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

Ayrıca E-Tablolar API v4, spreadsheets.batchUpdate içinde AppendCells isteklerini kullanarak belirli özelliklere ve biçimlendirmeye sahip hücreler eklemenize de olanak tanır.

v3 API

Bir veri satırını düzenlemek için güncellemek istediğiniz satırın girişini bulmak üzere liste feed'ini inceleyin. Gerekirse bu girişin içeriğini güncelleyin. Kullandığınız girişteki kimlik değerinin, mevcut girişin kimliğiyle tam olarak eşleştiğinden emin olun.

Giriş güncellendikten sonra, uygun bir yetkilendirme başlığı kullanarak girişi istek gövdesi olarak içeren bir PUT isteği, ilgili satır girişinde sağlanan edit URL'sine gönderin. Örneğin:

PUT https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

<entry gd:etag='"S0wCTlpIIip7ImA0X0QI"'>
  <id>rowId</id>
  <updated>2006-11-17T18:23:45.173Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#list"/>
  <title type="text">Bingley</title>
  <content type="text">Hours: 10, Items: 2, IPM: 0.0033</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version"/>
  <gsx:name>Bingley</gsx:name>
  <gsx:hours>20</gsx:hours>
  <gsx:items>4</gsx:items>
  <gsx:ipm>0.0033</gsx:ipm>
</entry>

v4 API

Sheets API v4 ile, düzenlemek istediğiniz satırın A1 gösterimini kullanarak bir satırı düzenleyebilir ve bu satırın üzerine yazmak için spreadsheets.values.update isteği gönderebilirsiniz. Belirtilen aralık yalnızca satırdaki ilk hücreyi referans almalıdır. API, güncellenecek hücreleri istekle sağlanan değerlere göre tahmin eder. Bunun yerine birden fazla hücre içeren bir aralık belirtirseniz sağladığınız değerler bu aralığa sığmalıdır. Aksi takdirde API bir hata döndürür.

Aşağıdaki örnek istek ve istek gövdesi, "Sayfa1"in dördüncü satırına veri ekler:

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet1!A4

{
   "values": [["Elizabeth", "2", "0.5", "60"]]
}

Satır verilerini spreadsheet.values.batchUpdate yönteminden de güncelleyebilirsiniz. Birden fazla satır veya hücre güncellemesi yapıyorsanız bu yöntemi kullanmak daha verimlidir.

Ayrıca E-Tablolar API v4, spreadsheets.batchUpdate içinde UpdateCells veya RepeatCell isteklerini kullanarak hücre özelliklerini ve hücre biçimlendirmesini düzenlemenize de olanak tanır.

v3 API

Bir satırı silmek için önce liste feed'inden silinecek satırı alın, ardından satırın girişinde sağlanan edit URL'sine bir DELETE isteği gönderin. Bu, satırı güncellemek için kullanılan URL ile aynıdır.

DELETE https://spreadsheets.google.com/feeds/list/spreadsheetId/sheetId/private/full/rowId/version

Aldıktan sonra başka bir istemci tarafından değiştirilen bir satırı silmediğinizden emin olmak istiyorsanız orijinal satırın ETag değerini içeren bir HTTP If-Match üstbilgisi ekleyin. Giriş öğesinin gd:etag özelliğini inceleyerek orijinal satırın ETag değerini belirleyebilirsiniz.

Satırın, siz aldıktan sonra başka bir kullanıcı tarafından güncellenip güncellenmediğine bakılmaksızın silinmesini istiyorsanız If-Match: * kullanın ve ETag'ı eklemeyin. (Bu durumda, satırı silmeden önce almanız gerekmez.)

v4 API

E-Tablolar API v4 ile satır silme işlemi, DeleteDimension isteği kullanılarak bir spreadsheet.batchUpdate yöntem çağrısıyla gerçekleştirilir. Bu istek, sütunları kaldırmak için de kullanılabilir. Geliştiriciler, bir satırın veya sütunun yalnızca bir bölümünü kaldırmayı seçebilir. Örneğin, aşağıdaki kod, belirli bir kimliğe sahip bir sayfanın 6. satırını kaldırır (satır dizinleri sıfır tabanlı olup startIndex dahildir ve endIndex hariçtir):

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId:batchUpdate

{
  "requests": [
    {
      "deleteDimension": {
        "range": {
          "sheetId": sheetId,
          "dimension": "ROWS",
          "startIndex": 5,
          "endIndex": 6
        }
      }
    }
  ],
}

Bir sayfanın sheetId değeri, spreadsheet.get yöntemi kullanılarak alınabilir.

v3 API

Belirli bir çalışma sayfası için hücre tabanlı bir feed'in URL'sini belirlemek amacıyla çalışma sayfası feed'ini inceleyin ve ilgilendiğiniz çalışma sayfası girişinde hücre feed'i URL'sini bulun.

Hücre tabanlı bir feed almak için uygun bir yetkilendirme başlığı kullanarak hücre feed'i URL'sine bir GET isteği gönderin. Örneğin:

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full

Hücrelere satır ve sütun numarası kullanılarak referans verilir. Belirli bir aralığı getirmek için max-row, min-row, max-col ve min-col sorgu parametreleri kullanılabilir. Örneğin, aşağıdaki ifade 2. satırdan başlayarak 4. sütundaki (D) tüm hücreleri alır:

GET https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full
             ?min-row=2&min-col=4&max-col=4

E-Tablolar API v3, alınan hücrelerin inputValue değerini döndürür. Bu değer, kullanıcının hücreyi değiştirmek için Google E-Tablolar kullanıcı arayüzüne yazacağı değerdir. inputValue, değişmez değer veya formül olabilir. API bazen numericValue değerini de döndürür. Örneğin, bir formül sayı sonucu verdiğinde. Örneğin, bir yanıt aşağıdakine benzer bir yapıya sahip hücre girişleri içerebilir:

<entry gd:etag='"ImB5CBYSRCp7"'>
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4</id>
  <updated>2006-11-17T18:27:32.543Z</updated>
  <category scheme="http://schemas.google.com/spreadsheets/2006"
    term="http://schemas.google.com/spreadsheets/2006#cell"/>
  <title type="text">D4</title>
  <content type="text">5</content>
  <link rel="self" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4"/>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R9C4/srevc"/>
  <gs:cell row="4" col="4" inputValue="=FLOOR(C4/(B4*60),.0001)"
    numericValue="5.0">5</gs:cell>
</entry>

v4 API

İlgili aralık veya aralıklar için spreadsheets.values.get veya spreadsheets.values.batchGet yöntemini çağırarak hücre verilerini alın. Örneğin, aşağıdaki formül, "Sayfa2"nin D sütunundaki hücreleri 2. satırdan başlayarak sütun öncelikli sırada döndürür ve formülleri girildiği şekilde döndürür (sonraki boş hücreler atlanır):

GET https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/Sheet2!D2:D?majorDimension=COLUMNS&valueRenderOption=FORMULA

Bu isteğe verilen yanıtın yapısı şuna benzer:

{
  "spreadsheetId": spreadsheetId,
  "valueRanges": [
      {"range": "Sheet2!D2:D",
       "majorDimension": "COLUMNS",
       "values": [["Widget", 234, "=FLOOR(C4/(B4*60),.0001)", "=D4\*1000"]]
      }]
}

Birden fazla hücre verisi aralığı almak istiyorsanız spreadsheet.values.batchGet işlevini kullanmak daha verimlidir. Biçimlendirme gibi hücre özelliklerine erişmek istiyorsanız spreadsheet.get yöntemini kullanmanız gerekir.

v3 API

Tek bir hücrenin içeriğini düzenlemek için önce hücre feed'inde hücrenin girişini bulun. Giriş bir düzenleme URL'si içeriyor. Giriş, hücrenin sahip olmasını istediğiniz içeriği yansıtacak şekilde güncellenir ve ardından, güncellenmiş hücre girişinin istek gövdesi olarak kullanıldığı düzenleme URL'sine bir PUT isteği gönderilir. Örneğin, aşağıdaki formül D2 hücresini (R2C4) SUM formülü içerecek şekilde günceller:

PUT https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full//R2C4/srevc

<entry xmlns="http://www.w3.org/2005/Atom"
    xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
  <link rel="edit" type="application/atom+xml"
    href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4"/>
  <gs:cell row="2" col="4" inputValue="=SUM(A1:B6)"/>
</entry>

v4 API

Sheets API v4'te tek hücre düzenlemesi, spreadsheets.values.update yöntemiyle yapılabilir. Bu yöntem için ValueInputOption sorgu parametresi gerekir. Bu parametre, giriş verilerinin E-Tablolar kullanıcı arayüzüne girmiş gibi mi (USER_ENTERED) yoksa ayrıştırılmaksızın olduğu gibi mi (RAW) işleneceğini belirtir. Örneğin, aşağıdaki kod D2 hücresini bir formülle günceller:

PUT https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values/D2?valueInputOption=USER_ENTERED

{"values": [["=SUM(A1:B6)"]]}

Birden fazla hücre düzenlemesi yapıyorsanız bunları tek bir istekle göndermek için spreadsheets.values.batchUpdate yöntemini kullanın.

v3 API

Birden fazla hücreyi düzenlemek için önce çalışma sayfası için bir hücre feed'i alın. Giriş bir toplu URL içeriyor. Bu URL'ye bir POSTisteği gönderin. Bu isteğin gövdesinde, güncellemek istediğiniz hücreleri ve yeni hücre içeriğini açıklayın. POST isteği ve istek gövdesi aşağıdakine benzer bir yapıya sahiptir:

POST https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/batch

<feed xmlns="http://www.w3.org/2005/Atom"
      xmlns:batch="http://schemas.google.com/gdata/batch"
      xmlns:gs="http://schemas.google.com/spreadsheets/2006">
  <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full</id>
  <entry>
    <batch:id>request1</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C4/version"/>
    <gs:cell row="2" col="4" inputValue="newData"/>
  </entry>
  ...
  <entry>
    <batch:id>request2</batch:id>
    <batch:operation type="update"/>
    <id>https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5</id>
    <link rel="edit" type="application/atom+xml"
      href="https://spreadsheets.google.com/feeds/cells/spreadsheetId/sheetId/private/full/R2C5/version"/>
    <gs:cell row="5" col="2" inputValue="moreInfo"/>
  </entry>
</feed>

batch:id alanı, isteği grup içinde benzersiz şekilde tanımlamalıdır. Hücre düzenlemelerinde batch:operation alanı update olmalıdır. gs:cell, hücreyi satır ve sütun numarasına göre tanımlar ve buraya eklenecek yeni verileri sağlar. id, güncellenecek hücrenin tam URL'sini içerir. link, hücre kimliğinin tam yolunu içeren bir href özelliğine sahip olmalıdır. Her giriş için bu alanların tümü gereklidir.

v4 API

Sheets API v4, spreadsheets.values.batchUpdate yöntemi aracılığıyla hücre değerlerinin toplu olarak düzenlenmesini sağlar.

Birden fazla hücreyi düzenlemek için istek gövdesinde veri değişiklikleri belirtilen bir POST isteği gönderebilirsiniz. Örneğin:

POST https://sheets.googleapis.com/v4/spreadsheets/spreadsheetId/values:batchUpdate

{
  "valueInputOption": "USER_ENTERED"
  "data": [
       {"range": "D4",
        "majorDimension": "ROWS",
        "values": [["newData"]]
       },
       {"range": "B5",
        "majorDimension": "ROWS",
        "values": [["moreInfo"]]
       }
  ]
}

Aralık olarak tek bir hücre belirttiyseniz sağlanan tüm değerler, sol üst koordinat olarak bu hücreden başlayarak sayfaya yazılır. Bunun yerine çok hücreli bir aralık belirtirseniz sağladığınız değerler bu aralığa tam olarak uymalıdır. Aksi takdirde API bir hata döndürür.