Google Search Engine Info aksiyonu, Google Custom Search API entegrasyonunun yapılandırma bilgilerini almak için kullanılır. Özellikle entegrasyon ayarlarını (API key, arama motoru kimliği – CX) doğrulamak ve arama fonksiyonunun doğru çalıştığından emin olmak amacıyla tercih edilir.

Teknik Özellikler

• İşlev: Google Custom Search ayarlarını (settings) kontrol eder, entegrasyonun doğru yapılandırıldığını doğrular.
• Parametreler:
  
  • settings (Object – zorunlu): Google Search API ayarlarını içerir (API key ve arama motoru kimliği).
• Sonuç: Tekil (One) → Arama motoru ayarlarını veya doğrulama çıktısını içeren nesne döner.

Değer Bağlama

• Sabit değer (Fixed Value).
• Dinamik değer (ör. kullanıcıdan alınan ya da sistemde kayıtlı API ayarları).

Google Search Engine Info Uygulama Adımları

1. Aksiyon Ekleme

• Projede arama fonksiyonunun kullanılacağı ekrana gidin.
• UI Design → + ADD ACTION → Google → Google Search Engine Info seçin.

2. Parametreleri Yapılandırma

• settings: Google API key ve Custom Search Engine (CX) bilgilerini içeren ayarları seçin.
• Enable Audit Log: Aktif edildiğinde, aktif delegasyonların sorgulanması işlemi audit log kayıtlarına eklenir. Bu sayede hangi kullanıcının delegasyon bilgilerinin, ne zaman ve hangi aksiyon aracılığıyla görüntülendiği izlenebilir.

3. Çalıştırma
   
   • Aksiyon çalıştırıldığında, entegrasyon ayarlarının geçerli olup olmadığı test edilir.
   • Sonuçta ayarlara ait bilgi veya hata çıktısı döner.

Kullanım Senaryosu: "Google Search Entegrasyonu Testi"

Bir uygulama geliştiricisi, Google arama entegrasyonunu projeye yeni eklediğinde:

• settings içine Google API Key ve CX kimliği tanımlanır.
• Google Search Engine Info aksiyonu çalıştırılır.
• Entegrasyon geçerli ise "ayarlar doğrulandı" çıktısı alınır.
• Hatalı ise "API key geçersiz" veya "CX bulunamadı" gibi hata mesajı döner.

Google Search Engine Info İleri Seviye Özelleştirmeler

• Debug Amaçlı Kullanım: Arama sonuçları gelmediğinde sorun settings tarafında mı yoksa query tarafında mı, bunu anlamak için kullanılır.
• Kullanıcıya Bilgi Gösterme: Kullanıcıya hangi Custom Search Engine (CX) ile arama yapıldığını gösteren bir bilgi ekranında kullanılabilir.
• Ortam Bazlı Ayarlar: Test ortamı ve canlı ortamda farklı settings kullanılabilir.

Teknik Riskler ve Kontroller

• settings boş bırakılırsa aksiyon çalışmaz.
• Yanlış API key veya CX kimliği girilirse hata döner.
• Bu aksiyon arama yapmaz, yalnızca entegrasyon ayarlarını kontrol eder.
• API kota sınırlamalarına dikkat edilmelidir.