Skip to main content

Google Search API

Siesta AI - Google Search gjør det mulig å programmatisk utføre websøking via Google Custom Search JSON API. Tilkoblingen er read-only og returnerer strukturert JSON med resultater.

1. Konfigurering av Google Search API (praktisk veiledning)​

  1. Prosjekt i Google Cloud: bruk et eksisterende eller opprett et nytt prosjekt.
  2. Aktiver Custom Search API: søk etter "Custom Search API" i API-biblioteket og klikk Enable. Aktivering av Custom Search API i API-biblioteket
  3. Opprett Programmable Search Engine: gå til https://programmablesearchengine.google.com/ åpne listen over søkemotorer og klikk Legg til. Listen over søkemotorer i Programmable Search Engine Oppretting av ny søkemotor
  4. Få Search Engine ID (cx): i detaljene for søkemotoren åpner du seksjonen Grunnleggende og kopierer Søkemotor-ID. Kopiere Search Engine ID (cx)
  5. Generer API-nøkkel: i Google Cloud Console -> APIs & Services -> Credentials -> Opprett legitimasjon -> API-nøkkel. Oppretting av API-nøkkel i Credentials
  6. Begrensning av nøkkelen (anbefalt):
    • Applikasjonsbegrensninger: etter behov (Ingen/Nettsider/IP).
    • API-begrensninger: Begrens nøkkel -> Custom Search API.
  7. Innstillinger i Siesta AI:
    • Tilkobling -> Legg til tilkobling -> GoogleSearch.
    • Fyll ut Key (API-nøkkel) og Cx (Søkemotor-ID) og velg Delt/Privat.
    • Lagre ved å klikke Fortsett. Innstillinger for GoogleSearch-tilkobling i Siesta AI

2. Formålet med dokumentet​

Målet er å muliggjøre programmatisk tilgang til resultater fra websøking via Google Custom Search JSON API.

3. Oversikt over Tilkoblinger​

  • Navn på Tilkobling: GoogleSearch
  • Type: REST API - Google Custom Search JSON API
  • Autentisering: API-nøkkel (Google Cloud) + Søkemotor-ID (cx) (OAuth er ikke nødvendig)
  • Omfang: kun lesing/søking
  • Utdata: JSON-objekt med søkeresultater
  • Merk: Det finnes ingen skriveoperasjoner; alle kall er idempotente.

Google Custom Search JSON API gjør det mulig å programmatisk hente søkeresultater fra Google via Programmable Search Engine, som må opprettes og konfigureres før bruk.

4. Generelle prinsipper​

4.1 Konfigurasjon​

  • Søkemotor-ID (cx): identifikator for din egen søkeinstans.
  • API-nøkkel: obligatorisk parameter for autoriserte kall til Google API.
  • Utdata: JSON inneholder metadata om søk og resultatsett (tittel, utdrag, URL, pagemap osv.).

4.2 Spørringssyntaks​

  • Parameteren query (alias q) angir søkeuttrykket.
  • Avanserte operatorer som site:, intitle: osv. kan brukes (standard Google spørringssyntaks).

5. API-operasjoner​

5.1 Søk​

Beskrivelse: Utfører websøking via Google Custom Search JSON API.
HTTP: GET https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}

ParameterTypePåkrevdBeskrivelse
queryStringJaSøkeuttrykk (f.eks. "AI best practices").

Utdata

  • Liste over resultater (tittel, URL, utdrag)
  • Metadata om antall resultater
  • Eventuelle andre blokker (pagemap)

Atferd og begrensninger

  • Standard respons ~10 resultater per side; flere sider via start (utenfor omfanget av Tilkoblingen).

Typiske feil

  • 400 Bad Request - ugyldig spørring
  • 401 Unauthorized - ugyldig API-nøkkel
  • 403 Quota Exceeded - overskredet daglig kvote

6. Sikkerhet og styring​

  • Oppbevar API-nøkkelen sikkert; foretrekk begrensninger (domener/IP, begrensning til Custom Search API).
  • Overvåk kvoter og logg for fakturakontroll.
  • Logg minst: query-strengen, tidspunkt for kall, antall resultater, HTTP-status.

7. Driftsanbefalinger​

  • Sett opp en roteringspolitikk for API-nøkkelen (Roter nøkkel i Google Cloud Console).
  • Hold cx og API-nøkkelen i et sikkert hemmelighetslager; oppdater Tilkoblingen ved endring av nøkkelen.

8. Eksempel på bruk​

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

Forkortet JSON:

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