Přeskočit na hlavní obsah

Google Search Connector

Siesta AI - Google Search Connector umožňuje programaticky spouštět webové vyhledávání přes Google Custom Search JSON API. Konektor je read-only a vrací strukturovaný JSON s výsledky.

1. Nastavení Google Search API (praktický postup)​

  1. Projekt v Google Cloud: použij existující nebo vytvoř nový projekt.
  2. Povol Custom Search API: v API Library vyhledej "Custom Search API" a klikni Enable. Aktivace Custom Search API v API Library
  3. Vytvoř Programmable Search Engine: na https://programmablesearchengine.google.com/ otevři seznam vyhledávačů a klikni Přidat. Seznam vyhledávačů v Programmable Search Engine Vytvoření nového vyhledávače
  4. Získej Search Engine ID (cx): v detailu vyhledávače otevři sekci Základní a zkopíruj ID vyhledávače. Zkopírování Search Engine ID (cx)
  5. Vygeneruj API Key: v Google Cloud Console -> APIs & Services -> Credentials -> Create credentials -> API key. Vytvoření API klíče v Credentials
  6. Restrikce klíče (doporučeno):
    • Application restrictions: dle potřeby (None/Websites/IP).
    • API restrictions: Restrict key -> Custom Search API.
  7. Nastavení v Siesta AI:
    • Konektory -> Add Connection -> GoogleSearch.
    • Vyplň Key (API Key) a Cx (Search Engine ID) a zvol Shared/Private.
    • Ulož přes Continue. Nastavení konektoru GoogleSearch v Siesta AI

2. Účel dokumentu​

Cílem je umožnit programatický přístup k výsledkům webového vyhledávání přes Google Custom Search JSON API.

3. Přehled konektoru​

  • Název konektoru: GoogleSearch
  • Typ: REST API - Google Custom Search JSON API
  • Autentizace: API Key (Google Cloud) + Search Engine ID (cx) (OAuth není potřeba)
  • Scope: pouze read/search
  • Výstup: JSON objekt s výsledky vyhledávání
  • Pozn.: Neexistují operace zápisu; všechna volání jsou idempotentní.

Google Custom Search JSON API umožňuje programaticky získávat výsledky vyhledávání z Google přes Programmable Search Engine, které je třeba před použitím vytvořit a nakonfigurovat.

4. Obecné principy​

4.1 Konfigurace​

  • Search Engine ID (cx): identifikátor vlastní vyhledávací instance.
  • API Key: povinný parametr pro autorizované volání Google API.
  • Výstup: JSON obsahuje metadata vyhledávání a výsledkovou sadu (title, snippet, URL, pagemap atd.).

4.2 Dotazovací syntax​

  • Parametr query (alias q) určuje hledaný výraz.
  • Lze použít pokročilé operátory jako site:, intitle: atd. (standardní Google query syntax).

5. API operace​

Popis: Provede webové vyhledávání přes Google Custom Search JSON API.
HTTP: GET https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}

ParameterTypeRequiredDescription
queryStringYesHledaný výraz (např. "AI best practices").

Výstup

  • Seznam výsledků (title, URL, snippet)
  • Metadata o počtu výsledků
  • Případné další bloky (pagemap)

Chování a limity

  • Standardní response ~10 výsledků na stránku; další stránky přes start (mimo scope konektoru).

Typické chyby

  • 400 Bad Request - nevalidní query
  • 401 Unauthorized - neplatný API Key
  • 403 Quota Exceeded - překročena denní kvóta

6. Bezpečnost a governance​

  • API Key uchovávej bezpečně; preferuj restrikce (domény/IP, omezení na Custom Search API).
  • Monitoruj kvóty a loguj pro billing kontrolu.
  • Loguj minimálně: query string, čas volání, počet výsledků, HTTP status.

7. Provozní doporučení​

  • Nastav rotační politiku pro API Key (Rotate key v Google Cloud Console).
  • Udržuj cx a API Key v bezpečném secrets store; při změně klíče aktualizuj konektor.

8. Příklad použití​

GET https://www.googleapis.com/customsearch/v1
  ?key=YOUR_API_KEY
  &cx=YOUR_SEARCH_ENGINE_ID
  &q=cloud+infrastructure+best+practices

Zkrácený JSON:

{
  "queries": { "request": [ { "query": "cloud infrastructure best practices" } ] },
  "items": [
    { "title": "...", "link": "...", "snippet": "..." }
  ]
}