n8n ile Google Sheets Nasıl Kullanılır?

n8n'de Google Sheets'e veri yazmak, veri okumak ya da bir sayfadaki değişiklikle bir workflow'u başlatmak için Google Sheets node'u ve Google Sheets Trigger node'u kullanılır. Node, n8n'de bir workflow içindeki tek adımdır. Workflow ise bir işi otomatik yapan node'ların bütünüdür. Node'lar editörde canvas üzerinde kutu olarak görünür. Canvas, node'ların eklenip birbirine bağlandığı çalışma alanıdır. Trigger node, workflow'u belirli bir olayda ya da zamanda başlatan özel node'dur.

Google Sheets, Google'ın web tabanlı hesap tablosu programıdır. Bir hesap tablosu (spreadsheet) bir ya da daha çok sayfadan (sheet) oluşur.

n8n'de Google Sheets node'u ne işe yarar?

n8n belgelerine göre Google Sheets node'u, Google Sheets'teki işleri otomatikleştirmek ve Google Sheets'i başka uygulamalara bağlamak için kullanılır. Node'un işlemleri iki gruba ayrılır: hesap tablosunun kendisiyle ilgili işlemler (Document) ve hesap tablosundaki bir sayfayla ilgili işlemler (Sheet Within Document).

Örnek: Bir kişi, ürün kodlarına göre stok bilgisini tutan bir sayfada Append or Update Row işlemini kullanır. Ürün kodu sayfada varsa o satır güncellenir, yoksa sayfanın sonuna yeni bir satır eklenir.

API, bir yazılımın başka bir yazılıma istek gönderip cevap alabildiği arayüzdür. Belgelere göre Google Sheets node'u istenen işlemi desteklemiyorsa HTTP Request node'uyla Google Sheets API'sine doğrudan istek gönderilebilir. HTTP Request node'u, bir web adresine istek gönderip cevabı alan node'dur.

Örnek: Bir kişi, web sitesindeki iletişim formundan gelen her mesajı Append Row işlemiyle bir sayfaya ekleyen bir workflow kurar. Sayfada her mesaj için ad, e-posta ve mesaj sütunları dolar.

Temel n8n kavramları n8n nedir yazısında anlatılır.

n8n Google Sheets'e nasıl bağlanır?

Credential, n8n'in bir hizmete bağlanmak için gereken giriş bilgisini sakladığı kayıttır. Bir node'un kullanacağı credential, node'un Credential to connect with alanında seçilir. n8n belgelerine göre Google node'ları iki kimlik doğrulama yöntemini destekler: OAuth2 ve Service Account. Belgeler, daha yaygın olduğu ve kurulumu daha kolay olduğu için OAuth2'yi önerir.

OAuth2, bir uygulamanın kullanıcının şifresini görmeden hesabına erişim izni almasını sağlayan yöntemdir. Service Account ise bir uygulamanın kişi yerine kendi adına kullandığı Google hesabıdır. n8n Cloud, n8n şirketinin işlettiği sunucularda çalışan ve tarayıcıdan kullanılan sürümdür. Kendi sunucusunda çalışan n8n ise kullanıcının n8n'i kendi bilgisayarına ya da sunucusuna kurduğu sürümdür. Google Cloud Console, Google hizmetlerine bağlanan uygulamaların ayarlandığı Google sitesidir. Belgelere göre kurulum, n8n'in nerede çalıştığına göre değişir:

Service Account kurulumu bu yazının kapsamında değildir. n8n belgelerine göre n8n Cloud'da bağlantı şu adımlarla kurulur:

1. Canvas'taki bir node'un sağındaki "Add node" (+) düğmesine tıkla. n8n, node'ları arayıp seçebildiğin node panelini (nodes panel) açar.
2. Arama kutusuna "Google Sheets" yaz, Google Sheets'i ve ardından bir işlemi seç. n8n node'u canvas'a ekler ve ayarlarını açar.
3. Credential to connect with listesinde "Create new credential" seçeneğini seç. Credential penceresi açılır.
4. Credential penceresinde "Sign in with Google" düğmesine tıkla. Google'ın giriş penceresi açılır.
5. Google'ın giriş penceresinde hesabını seç. Hesabın listede yoksa e-posta adresini ve şifreni gir. Google, n8n'in hesaba erişmek için izin istediğini gösteren bir pencere açar.
6. İzin penceresinde n8n'e erişim izni ver. Pencere kapanır ve credential penceresine dönülür.
7. "Save" düğmesine tıkla ve credential penceresini kapat. Node artık bu Google hesabındaki hesap tablolarına erişebilir.

Örnek: n8n Cloud kullanan bir kişi, Managed OAuth2 ile credential penceresinde "Sign in with Google" düğmesine tıklar ve bağlanır. Kendi sunucusunda n8n çalıştıran bir kişi ise Google Cloud Console'da kendi uygulamasını açarak Custom OAuth2 kurar.

Kendi sunucusunda n8n çalıştıran kullanıcı belgelere göre şu adımları izler:

1. Tarayıcıda console.cloud.google.com adresini aç ve Google hesabınla giriş yap. Üstteki proje listesinden "New project" seçeneğiyle yeni bir proje oluştur.
2. APIs & Services > Library sayfasında Google Sheets API'yi ve Google Drive API'yi bul. İkisi için de "ENABLE" düğmesine tıkla.
3. APIs & Services > OAuth consent screen sayfasında App name ve User support email alanlarını doldur.
4. Audience ayarında kuruluş içi kullanım için Internal, kuruluş dışındaki Google hesapları için External seç. External seçilirse uygulama Testing modunda başlar.
5. APIs & Services > Credentials sayfasında "+ Create credentials" > "OAuth client ID" seç ve Application type olarak Web application seç.
6. n8n'deki credential penceresinden OAuth Redirect URL'yi kopyala ve Google'daki Authorized redirect URIs alanına yapıştır.
7. Google'ın gösterdiği Client ID ve Client Secret değerlerini n8n'deki credential penceresine gir. "Sign in with Google" düğmesine tıkla ve credential'ı kaydet.

n8n'in kurulum yolları n8n kurulumu nasıl yapılır yazısında anlatılır.

n8n ile Google Sheets'e nasıl satır eklenir?

Append Row işlemiyle sayfaya yeni satır eklemek için şu adımları izle:

1. Google Sheets node'unda işlem olarak Append Row'u seç.
2. Document alanında hesap tablosunu From list, By URL ya da By ID seçeneğiyle seç. From list ile hesap tablosunu listeden, By URL ile adresinden, By ID ile kimliğinden seçersin.
3. Sheet alanında satırın ekleneceği sayfayı seç.
4. Mapping Column Mode alanında Map Each Column Manually ya da Map Automatically seçeneğini seç.
5. Node'daki "Execute step" düğmesine tıkla ve Google Sheets'te sayfanın sonuna yeni satırın eklendiğini kontrol et.

Belgelere göre hesap tablosunun kimliği (spreadsheetId), hesap tablosunun adresinde "/d/" ile "/edit" arasında durur. Map Automatically seçilirse önceki node'dan gelen verideki alan adları Google Sheets'teki sütun adlarıyla aynı olmalıdır. Alan adları farklıysa Google Sheets node'undan önce bir Edit Fields node'u eklenir. Edit Fields, verideki alan adlarını ve değerlerini düzenleyen node'dur.

Örnek: Gelen verideki alan adı "email", sayfadaki sütun adı "E-posta" ise Map Automatically bu sütunu doldurmaz. Kullanıcı Edit Fields node'uyla alan adını "E-posta" yapınca sütun dolar.

n8n ile Google Sheets'ten veri nasıl okunur?

n8n belgelerine göre Get Row(s) işlemi varsayılan olarak sayfadaki başlık satırı dışındaki bütün satırları döndürür. Filters seçeneğiyle sonuç sınırlanabilir. Filtre birden çok satırla eşleşirse n8n sadece ilk sonucu döndürür. Bütün eşleşmeler için When Filter Has Multiple Matches seçeneğinde Return All Matches seçilir.

Belgelere göre n8n ilk satırı başlık satırı sayar ve sonuca eklemez. İlk satırı da okumak için Options bölümündeki Data Location on Sheet seçeneği kullanılır. Okunan değerlerin biçimi de seçilebilir:

Örnek: Bir kişi, her sabah kendiliğinden başlayan bir workflow kurar. Workflow'u her sabah başlatan node, Schedule Trigger node'udur. Workflow, Get Row(s) ile "Görevler" sayfasından durumu "bekliyor" olan satırları okur ve listeyi kişiye e-postayla gönderir.

Google Sheets'teki değişiklikle workflow nasıl başlatılır?

Belgelere göre Google Sheets Trigger node'u üç olayı destekler. Olay, node'un Trigger On alanında seçilir:

Örnek: Bir ekip, sipariş sayfasına yeni satır eklendiğinde Row Added olayıyla başlayan bir workflow kurar. Workflow, yeni siparişin bilgisini ekibin sohbet kanalına mesaj olarak gönderir.

Belgelere göre Google Sheets Trigger node'u "Execute step" ya da "Execute workflow" düğmesiyle denenirken node takılı kalmış gibi görünebilir. Ters vekil sunucusu (reverse proxy), n8n'in önüne konup gelen istekleri n8n'e ileten sunucudur. Websocket ise tarayıcıyla sunucu arasında açık kalan iki yönlü bağlantıdır. Bu durum çoğunlukla, websocket desteği açılmamış bir ters vekil sunucusunun arkasında çalışan n8n'de görülür. Çözüm, ters vekil sunucusunda websocket desteğini açmaktır. Belgeler bu tür sunuculara Nginx, Caddy, Apache HTTP Server ve Traefik'i örnek verir.

n8n Google Sheets'te hangi sorunlar çıkar?

n8n belgelerine göre sık görülen sorunlar ve çözümleri şunlardır:

• Sütun adları node kurulduktan sonra değiştiyse hata alınır. Mapping Column Mode yeniden seçilirse node sütun adlarını yeniden çeker.
• Google Sheets'e bir dizi (array), yani birden çok değerden oluşan bir liste doğrudan eklenemez. Liste önce JSON biçimine, yani verinin ad ve değer çiftleriyle yazıldığı biçime çevrilir. Bunun için Split Out ya da Code node'u kullanılabilir. Split Out, bir listeyi ayrı öğelere bölen node'dur. Code node'u ise JavaScript ya da Python kodu çalıştıran node'dur.
• Google Sheets Trigger node'unda tarih ve saat sütunları sayı olarak görünebilir. DateTime Render seçeneğinde Formatted String seçilirse bu sütunlar metin olarak gelir.
• Google hesabıyla bağlanırken "Google hasn't verified this app" uyarısı görülebilir. Audience ayarında External seçildiyse giriş yapan e-posta adresi Google Cloud Console'daki Test users listesine eklenmelidir.
• redirect_uri_mismatch hatası, n8n'in gönderdiği OAuth Redirect URL'nin Google'daki Authorized redirect URIs alanındaki adresle eşleşmediğini gösterir. Adres Google'a protokolüyle (http ya da https) ve varsa port numarasıyla birlikte aynen yapıştırılır.

Sonraki adım

n8n'de yeni bir workflow aç ve bir Google Sheets node'u ekle. Credential'ı bağla, boş bir deneme hesap tablosu seç ve Append Row işlemiyle tek bir satır ekle. Google Sheets'te satırın sayfanın sonuna eklendiğini kontrol et.