Google Search aksiyonu, uygulama içinden Google üzerinden arama yapılmasını sağlar. Kullanıcıların yazdığı sorguya göre web sonuçları, belirli bir siteye kısıtlı aramalar veya dosya türü/ülke/dil bazlı filtrelenmiş arama sonuçları döndürmek için kullanılır.

Teknik Özellikler

• İşlev: Google üzerinde dinamik arama yapma.
• Parametreler:
  
  • settings (Object – zorunlu): Google Search API ayarları.
  • query (String – zorunlu): Aranacak anahtar kelime (örn. "Kuika Low-code platform").
  • count (Int32 – opsiyonel): Kaç sonuç getirileceği (varsayılan 10).
  • offset (Int32 – opsiyonel): Sonuçlarda kaçıncı sayfadan başlanacağı.
  • safe (Enum – opsiyonel): Güvenli arama filtresi (aktif/pasif).
  • search_type (String – opsiyonel): Arama türü (örn. "image" → görsel arama).
  • siteSearch (String – opsiyonel): Belirli bir site içinde arama yapma (örn. "kuika.com").
  • siteSearchFilterType (Enum – opsiyonel): Site içi aramayı dahil et / hariç tut.
  • file_type (String – opsiyonel): Dosya türüne göre filtre (örn. "pdf", "docx").
  • language (String – opsiyonel): Sonuçların dili (örn. "tr", "en").
  • country (String – opsiyonel): Sonuçların ülke filtresi (örn. "tr", "us").
• Sonuç: Tekil (One) → Arama sonuçları nesnesi döner.

Google Search Uygulama Adımları

1. Aksiyon Ekleme

• Ekrana gidin → + ADD ACTION → Google →Google Search seçin.

2. Parametreleri Belirleme

• query: "Kuika AI Agents".
• count: 5 (ilk 5 sonuç).
• language: "tr".
• country: "tr".
• siteSearch: "medium.com" (yalnızca Medium üzerindeki içerikler).

Google Search Kullanım Senaryosu

1. Uygulama İçi Haber Arama

Kullanıcı "low-code trends" yazdığında → Google Search aksiyonu çalışır → İlk 10 İngilizce haber sonuçları listelenir.

2. Siteye Özel Arama

Kullanıcı "Kuika Release Notes" aradığında → siteSearch = "kuika.com" → Sadece Kuika web sitesindeki sonuçlar döner.

3. Dosya Türü Arama

Kullanıcı "project documentation" aradığında → file_type = "pdf" → Yalnızca PDF dosyaları bulunur.

Google Search İleri Seviye Özelleştirmeler

• Dinamik Arama: Kullanıcı query’yi uygulama içi arama kutusuna yazar.
• Sayfalama: offset parametresi ile sonraki sayfalar alınır.
• Görsel Arama: search_type = "image" → sadece görseller döner.
• Filtreli Arama: Güvenli arama için safe parametresi "active" yapılır.

Teknik Riskler ve Kontroller

• API kota limitleri dikkatle yönetilmelidir.
• Çok geniş query veya yüksek count değerleri performansı etkileyebilir.
• siteSearch kullanıldığında, ilgili sitenin Google tarafından indexlenmiş olması gerekir.