Skip to main content

Google Search API

Siesta AI - Google Search umožňuje programaticky spúšťať webové vyhľadávanie cez Google Custom Search JSON API. Pripojenie je read-only a vracia štruktúrovaný JSON s výsledkami.

1. Nastavenie Google Search API (praktický postup)​

  1. Projekt v Google Cloud: použij existujúci alebo vytvor nový projekt.
  2. Povoľ Custom Search API: v API Library vyhľadaj "Custom Search API" a klikni Enable. Aktivácia Custom Search API v API Library
  3. Vytvor Programmable Search Engine: na https://programmablesearchengine.google.com/ otvori zoznam vyhľadávačov a klikni Pridať. Zoznam vyhľadávačov v Programmable Search Engine Vytvorenie nového vyhľadávača
  4. Získaj Search Engine ID (cx): v detaile vyhľadávača otvori sekciu Základné a skopíruj ID vyhľadávača. Skopírovanie Search Engine ID (cx)
  5. Vygeneruj API Key: v Google Cloud Console -> APIs & Services -> Credentials -> Create credentials -> API key. Vytvorenie API kľúča v Credentials
  6. Obmedzenie kľúča (odporúčané):
    • Application restrictions: podľa potreby (None/Websites/IP).
    • API restrictions: Restrict key -> Custom Search API.
  7. Nastavenie v Siesta AI:
    • Pripojenie -> Add Connection -> GoogleSearch.
    • Vyplň Key (API Key) a Cx (Search Engine ID) a zvoľ Shared/Private.
    • Ulož cez Continue. Nastavenie Pripojenia GoogleSearch v Siesta AI

2. Účel dokumentu​

Cieľom je umožniť programatický prístup k výsledkom webového vyhľadávania cez Google Custom Search JSON API.

3. Prehľad Pripojenia​

  • Názov Pripojenia: GoogleSearch
  • Typ: REST API - Google Custom Search JSON API
  • Autentizácia: API Key (Google Cloud) + Search Engine ID (cx) (OAuth nie je potrebné)
  • Scope: iba read/search
  • Výstup: JSON objekt s výsledkami vyhľadávania
  • Pozn.: Neexistujú operácie zápisu; všetky volania sú idempotentné.

Google Custom Search JSON API umožňuje programaticky získavať výsledky vyhľadávania z Google cez Programmable Search Engine, ktoré je potrebné pred použitím vytvoriť a nakonfigurovať.

4. Obecné princípy​

4.1 Konfigurácia​

  • Search Engine ID (cx): identifikátor vlastnej vyhľadávacej inštancie.
  • API Key: povinný parameter pre autorizované volanie Google API.
  • Výstup: JSON obsahuje metadata vyhľadávania a výsledkovú sadu (title, snippet, URL, pagemap atď.).

4.2 Dotazovacia syntax​

  • Parameter query (alias q) určuje hľadaný výraz.
  • Môžu sa použiť pokročilé operátory ako site:, intitle: atď. (štandardná Google query syntax).

5. API operácie​

Popis: Provedie webové vyhľadávanie cez Google Custom Search JSON API.
HTTP: GET https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}

ParameterTypeRequiredDescription
queryStringÁnoHľadaný výraz (napr. "AI best practices").

Výstup

  • Zoznam výsledkov (title, URL, snippet)
  • Metadata o počte výsledkov
  • Prípadné ďalšie bloky (pagemap)

Správanie a limity

  • Štandardná odpoveď ~10 výsledkov na stránku; ďalšie stránky cez start (mimo scope Pripojenia).

Typické chyby

  • 400 Bad Request - neplatný query
  • 401 Unauthorized - neplatný API Key
  • 403 Quota Exceeded - prekročená denná kvóta

6. Bezpečnosť a governance​

  • API Key uchovávaj bezpečne; preferuj obmedzenia (domény/IP, obmedzenie na Custom Search API).
  • Monitoruj kvóty a loguj pre billing kontrolu.
  • Loguj minimálne: query string, čas volania, počet výsledkov, HTTP status.

7. Prevádzkové odporúčania​

  • Nastav rotačnú politiku pre API Key (Rotate key v Google Cloud Console).
  • Udržuj cx a API Key v bezpečnom secrets store; pri zmene kľúča aktualizuj Pripojenie.

8. Príklad použitia​

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

Skračený JSON:

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