Google Sheets REST API

GET API

Bilgi

Bu sistem, Google Sheets tablolarınızı REST API'ye dönüştürür ve çeşitli filtreleme, sıralama ve sayfalama özellikleri sunar.

https://your-worker.url/[SHEET_ID]/[SHEET_NAME]?params

Kurulum

Google e-tablolarını https://docs.google.com/spreadsheets/u/0/ adresinden yönetebilirsiniz. Verilerin JSON formatında fetch edilebilmesi için aşağıdaki ayarları yapın;

Genel Erişimi Açın:

Dosya -> Paylaş -> Başkalarıyla paylaş -> Genel erişim -> Bağlantıya sahip olan herkes olarak ayarlayın.

Web'de Yayınla:

Dosya -> Paylaş -> Web'de yayınla -> Yayınla butonuna tıklayın. (Tüm dokümanı yayınlamanız yeterlidir).

Parametre Referansı

Sütun İşlemleri

Parametre	Açıklama	Örnek
`sutunlar`	Tüm sütun isimlerini JSON listesi olarak döner.	`?sutunlar=1`
`sutun`	Sadece belirtilen sütunları gösterir (virgülle ayırarak).	`?<sutun_adi>=<veri>,<veri>`

Özel Filtreleme Parametreleri

Parametre	Açıklama	Örnek
`date`	Tarih sütununda filtreleme yapar.	`?date=<sutun_adi>:<gg.aa.yyyy>`
`num`	Sayısal sütunda filtreleme yapar.	`?num=<sutun_adi>:<X>`
`tag`	Belirtilen sütundaki etiketlere göre filtreleme yapar.	`?tag=<sutun_adi>:<veri>`
`time`	Saat sütununda filtreleme yapar.	`?time=saat:14:30`

Date Parametre Değerleri

Değer	Açıklama	Örnek
`bugun`	Bugünkü kayıtları getirir	`date=<sutun_adi>:bugun`
`dun`	Dünkü kayıtları getirir	`date=<sutun_adi>:dun`
`hafta`	Son 1 haftadaki kayıtları getirir	`date=<sutun_adi>:hafta`
`ay`	Son 1 aydaki kayıtları getirir	`date=<sutun_adi>:ay`
`yil`	Son 1 yıldaki kayıtları getirir	`date=<sutun_adi>:yil`
`yeni`	En yeni kayıtları sıralar	`date=<sutun_adi>:yeni`
`eski`	En eski kayıtları sıralar	`date=<sutun_adi>:eski`
`DD.MM.YYYY`	Belirli bir tarihten itibaren kayıtları getirir	`date=<sutun_adi>:<gg.aa.yyyy>`
`DD.MM.YYYY`	Tarih aralığındaki kayıtları getirir	`date=<sutun_adi>:<gg.aa.yyyy>:<gg.aa.yyyy>`
`YYYY`	Sadece YYYY yılındaki kayıtları getirir	`date=<sutun_adi>:<yyyy>`
`*YYYY`	YYYY yılından önceki kayıtları getirir	`date=<sutun_adi>:*<yyyy>`
`YYYY*`	YYYY yılından sonraki kayıtları getirir	`date=<sutun_adi>:<yyyy>*`

Num Parametre Değerleri

Değer	Açıklama	Örnek
`kucuk`	Küçükten büyüğe sıralar	`num=<sutun_adi>:kucuk`
`buyuk`	Büyükten küçüğe sıralar	`num=<sutun_adi>:buyuk`
`ortalama`	Sütunun ortalamasını hesaplar	`num=<sutun_adi>:ortalama`
`toplam`	Sütunun toplamını hesaplar	`num=<sutun_adi>:toplam`
`X:Y`	İki sayı arasındaki değerleri listeler	`num=<sutun_adi>:<X>:<Y>`
`X`	Sadece X sayısı değerlerini listeler	`num=<sutun_adi>:<X>`
`*X`	X sayısından küçük değerleri listeler	`num=<sutun_adi>:*<X>`
`X*`	X sayısından büyük değerleri listeler	`num=<sutun_adi>:<X>*`

Tag Parametre Değerleri

Değer	Açıklama	Örnek
`tag`	Belirtilen etikete sahip kayıtları getirir	`tag=<sutun_adi>:<veri>`

Time Parametre Değerleri

Değer	Açıklama	Örnek
`yeni`	En yeni saatleri sıralar	`time=<sutun_adi>:yeni`
`eski`	En eski saatleri sıralar	`time=<sutun_adi>:eski`
`HH:MM`	Belirli bir saatten itibaren kayıtları getirir	`time=<sutun_adi>:<SS:DD>`
`HH`	Belirli bir saat içeren kayıtları getirir	`time=<sutun_adi>:<SS>`

Doğrudan Sütun Filtreleme

Parametre	Açıklama	Örnek
`<sutun_adi>`	Herhangi bir sütun adını parametre olarak kullanarak o sütunda doğrudan filtreleme yapar	`?<sutun_adi>=<veri>`

Arama ve Sıralama

Parametre	Açıklama	Örnek
`ara`	Tüm sütunlarda metin araması yapar. Joker karakter (*) kullanılabilir	`?ara=*<veri>`
`sirala`	Sonuçları A-Z doğru sıralar	`?sirala=<sutun_adi>:az`
`sirala`	Sonuçları Z-A doğru sıralar	`?sirala=<sutun_adi>:za`

Sayfalama

Parametre	Açıklama	Örnek
`limit`	Sayfa başına maksimum kayıt sayısı	`?limit=10`
`sayfa`	Getirilecek sayfa numarası	`?sayfa=2`
`sayfa=ilk`	İlk sayfa	`?sayfa=ilk`
`sayfa=son`	Son sayfa	`?sayfa=son`

Diğer Parametreler

Parametre	Açıklama	Örnek
`debug`	Yanıta hata ayıklama bilgilerini ekler	`?debug=1`
`random`	Rastgele kayıt getirir	`?random=true`
`save`	Veriyi farklı formatlarda indirmeyi sağlar (csv, xml, json)	`?save=csv`

Örnekler

Temel Liste

Tüm verileri listeler

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName

Filtreli Liste

yazar sütunu "Ahmet" olan ve tarih sütununda "2024" geçen kayıtları listeler.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?yazar=Ahmet&tarih=*2024*

Sıralı ve Sayfalanmış Liste

En yeni kayıtlara göre sıralanmış, sayfa başına 5 kayıt gösterilen listenin 2. sayfasını getirir.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?date=tarih:yeni&limit=5&sayfa=2

Özel Sütunlarla Arama

Tüm sütunlarda "js" geçen kayıtların sadece baslik ve tarih sütunlarını gösterir.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?sutun=baslik,tarih&ara=*js

Etiket Filtreli Liste

etiket sütununda "react" etiketine sahip kayıtları listeler.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?tag=etiket:react

Sayısal Filtreleme

Fiyatı 100-200 arasındaki ürünleri küçükten büyüğe sıralar.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?num=fiyat:100:200&num=fiyat:kucuk

Rastgele Kayıt

Rastgele bir kayıt getirir.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?random=true

CSV İndirme

Verileri CSV formatında indirir.

https://spreadsheets.ckoglu.workers.dev/sheetId/sheetName?save=csv

JSON Yanıt Formatı

{
  "total": [NUMBER],
  "sayfa": [NUMBER],
  "limit": [NUMBER],
  "results": [
    {
      "head1": "value1",
      "head2": "value2"
    },
    ...
  ]
}

{
  "ortalama": 25.5,
  "toplam": 255
}