Google E-Tabloları Uygulamanıza Nasıl Bağlanır

Google E-Tablolar'ı uygulamanıza bağlamak için bir Google Cloud projesinde Google Sheets API'yi etkinleştirin, bir hizmet hesabı oluşturun, e-tabloyu hizmet hesabının e-posta adresiyle paylaşın ve anahtarını sunucu tarafı bir gizli anahtar olarak saklayın. Sunucunuz daha sonra spreadsheets.values.get ile satırları okur ve spreadsheets.values.append ile satır ekler. Kullanıcıların kendi e-tablolarını bağlaması gerekiyorsa bunun yerine OAuth kullanın; e-tablo tamamen herkese açıksa okuma için basit bir API anahtarı yeterlidir.

Bu rehber hangi yöntemin uygun olduğunu, ihtiyaç duyulan çağrıları, kotaları ve tuzakları ve bir yapay zekâ uygulama oluşturucu için istemleri anlatır. Google ayrıntıları, Eylül 2026 itibarıyla Google'ın geliştirici dokümantasyonundan alınmıştır.

Neden bir e-tablo bağlanır

Yaygın nedenler:

• Ekibin iş akışını korumak. Personel bir fiyat listesini ya da çizelgeyi Sheets içinde düzenlemeye devam eder; uygulama bunu gösterir.
• Verileri insanların zaten baktığı yerde toplamak. Yeni kayıtlar, siparişler ya da form yanıtları satır olarak gelir.
• Raporlama. Uygulama verilerini, e-tablolarla çalışan kişiler için bir e-tabloya aktarın.
• Bir basamak. E-tablodan başlayıp sonra düzgün bir veritabanına geçin. Bkz. e-tabloyu bir uygulamaya nasıl dönüştürürsünüz.

Uygulamanızın Google'a nasıl giriş yapacağını seçin

Google'ın kimlik bilgileri rehberi üç tür tanımlar:

Çoğu uygulama için doğru seçim hizmet hesabıdır: size ait tek bir kimlik bilgisi seti, yalnızca açıkça paylaştığınız e-tablolara erişim.

Hizmet hesabıyla adım adım

1. Bir Google Cloud projesi oluşturun ya da seçin ve Google Sheets API'yi etkinleştirin.
2. Bir hizmet hesabı ve onun anahtarını oluşturun. Anahtar bir JSON dosyasıdır; bir parola gibi davranın.
3. E-tabloyu hizmet hesabının e-posta adresiyle paylaşın: yalnızca okuma için Görüntüleyici ya da yazmak için Düzenleyici olarak. Google'ın rehberi bunun normal paylaşım ekranından yapıldığını belirtir.
4. Anahtarı sunucunuzda gizli anahtar olarak saklayın, örneğin GOOGLE_SERVICE_ACCOUNT_JSON adıyla, ve e-tablo kimliğini (e-tablonun URL'sindeki uzun dizi) SHEET_ID olarak saklayın.
5. API'yi sunucudan çağırın; dilinizin Google istemci kütüphanesini kullanın.
6. Okumaları önbelleğe alın; çok sayıda ziyaretçi aynı veriyi görüyorsa kotaya takılmazsınız.

Kullanacağınız çağrılar

Google'ın değer okuma ve yazma rehberinden:

Aralıklar A1 gösterimi kullanır. Google, A1:B2 gibi sayfa adı olmayan bir aralığın ilk sayfaya uygulandığını belirtir; bu yüzden biri sekmeleri yeniden sıralarsa sürprizlerden kaçınmak için sekmeyi açıkça adlandırın.

RAW ve USER_ENTERED

Yazmalar bir valueInputOption gerektirir:

• RAW gönderdiğinizi tam olarak metin olarak saklar. =1+2 metin olarak =1+2 kalır.
• USER_ENTERED girdiyi Sheets'e yazılmış gibi işler: tarihler tarih olur ve =1+2 bir formüle dönüşür.

Uygulamanıza kullanıcıların yazdığı metni yazıyorsanız RAW kullanın. USER_ENTERED ile biri, bir meslektaşınız e-tabloyu açtığında çalışacak bir formül gönderebilir.

Kotalar ve hatalar

Eylül 2026 itibarıyla Google'ın Sheets API limitleri sayfası şunu listeler:

Dakika başına kotalar içinde kaldığınız sürece günlük limit yoktur. Aşmak 429: Çok fazla istek hatası döndürür ve Google kesilmiş üstel geri çekilme önerir: her başarısız denemeden sonra rastgele bir gecikmeyle daha uzun beklemek, bir üst sınıra kadar. Tek bir isteğin 180 saniyeden uzun sürmesi zaman aşımına yol açar.

Pratikte: API'yi her sayfa görüntülemesinde çağırmayın. E-tablo verisini bir dakika ya da daha uzun süre önbelleğe alın, okumaları batchGet ile toplu yapın ve mümkün olduğunda yazmaları da toplu yapın.

Seçenekler ve ödünleşimler

Çok kullanıcılı ya da hassas veri içeren her şey için veritabanı daha iyi bir doğruluk kaynağıdır. Bkz. veritabanı nedir.

Yapay zekâ oluşturucunuza verilecek istemler

Bir e-tabloyu okumak:

Menü sayfasında Google E-Tablomuzdaki "Menu" sekmesini göster. Sunucudan Google Sheets API'yi kullan; hizmet hesabının JSON anahtarı GOOGLE_SERVICE_ACCOUNT_JSON gizli anahtarında, e-tablo kimliği ise SHEET_ID içinde olsun. Menu!A2:D aralığını oku (ad, açıklama, fiyat, kategori). Sonucu 5 dakika önbelleğe al. API başarısız olursa son önbelleğe alınmış sürümü göster. Anahtarı asla tarayıcıya gönderme.

Satır yazmak:

Biri iletişim formunu gönderdiğinde, veriyi veritabanımıza kaydet ve ayrıca "Leads" sekmesine bir satır ekle (tarih, ad, e-posta, mesaj); bunu spreadsheets.values.append ile valueInputOption RAW kullanarak yap. Google 429 dönerse üstel geri çekilmeyle yeniden dene; hâlâ başarısız olursa potansiyel müşteriyi veritabanında tut ve daha sonra yeniden dene.

Sık yapılan hatalar

• E-tabloyu hizmet hesabının e-postasıyla paylaşmayı unutmak. Anahtar doğru olsa bile API bir izin hatası döndürür.
• Anahtarı ön yüzde ya da depoda tutmak. JSON anahtarı, onunla paylaşılan her e-tabloya erişim verir. Bkz. API anahtarlarını güvende tutma.
• Kullanıcı girdisi için USER_ENTERED kullanmak, bu da formül enjeksiyonuna izin verir.
• API'yi her istekte çağırmak ve ilk trafik artışında dakika başına kotaya takılmak.
• Sütun konumlarına bağımlı olmak. Biri bir sütun ekler ve uygulama yanlış veriyi okur. Başlık satırını okuyup adına göre eşleştirin ya da başlığı kilitleyin.
• E-tabloyu gerekenden daha geniş paylaşmak. "Bağlantısı olan herkes" onu herkese açık yapar.
• Bir e-tabloyu çok kullanıcılı bir veritabanı olarak kullanmak. Eşzamanlı yazmalar ve eksik izinler veri kaybına ya da sızıntısına yol açar.

Kontrol listesi

• Sheets API etkin; hizmet hesabı oluşturuldu
• E-tablo, hizmet hesabının e-postasıyla gereken en düşük rolle paylaşıldı
• Anahtar ve e-tablo kimliği sunucu tarafı gizli anahtarlar olarak saklandı
• Tüm çağrılar sunucudan yapılıyor
• Aralıklarda sekme adları kullanılıyor
• Kullanıcının sağladığı metin için RAW kullanılıyor
• Okumalar önbelleğe alındı; 429 geri çekilmeyle yönetiliyor
• Sheets kullanılamadığında uygulama zarifçe geriye dönüyor
• Hangi tarafın doğruluk kaynağı olduğuna karar verildi

Mythex'te Google E-Tablolar

Mythex'te Sheets ile çalışmanın iki farklı yolu vardır. Bağlayıcılar, Google hesabınızı Mythex'e bağlar; böylece siz geliştirirken ajan bunu kullanabilir, örneğin bir e-tabloyu okuyup ondan bir pano oluşturabilir. Dokümanlar, kimlik bilgisinin Mythex'in bağlantı hizmetinde kaldığını ve kodunuza asla girmediğini belirtir (bkz. Bağlayıcılar; Google'ın istediği her izni onaylayın). Yayımlanmış uygulamanın tek başına bir e-tabloyu okuyup yazabilmesi için güvenilir yol bu rehberdeki yoldur: proje gizli anahtarı olarak saklanan bir hizmet hesabı anahtarı ve sunucunuzdan Sheets API çağrıları; bu, Herhangi bir API'yi entegre etme tarifinde olduğu gibidir. E-tablonun ihtiyacını aşarsanız, ajandan verileri projenin veritabanına taşımasını ve onun üzerine bir pano kurmasını isteyin.

Sorular