Hoppa till huvudinnehåll

Google Search API

Siesta AI - Google Search möjliggör programmatisk körning av webbsökningar via Google Custom Search JSON API. Anslutningen är read-only och returnerar strukturerad JSON med resultaten.

1. Inställning av Google Search API (praktisk vägledning)​

  1. Projekt i Google Cloud: använd ett befintligt eller skapa ett nytt projekt.
  2. Aktivera Custom Search API: sök efter "Custom Search API" i API-biblioteket och klicka på Enable. Aktivering av Custom Search API i API-biblioteket
  3. Skapa Programmable Search Engine: gå till https://programmablesearchengine.google.com/ öppna listan över sökmotorer och klicka på Lägg till. Lista över sökmotorer i Programmable Search Engine Skapa en ny sökmotor
  4. Hämta Search Engine ID (cx): i detaljvyn för sökmotorn öppna sektionen Grundläggande och kopiera Sökmotor-ID. Kopiera Search Engine ID (cx)
  5. Generera API-nyckel: i Google Cloud Console -> APIs & Services -> Credentials -> Skapa autentiseringsuppgifter -> API-nyckel. Skapa API-nyckel i Credentials
  6. Begränsningar av nyckeln (rekommenderas):
    • Applikationsbegränsningar: efter behov (Ingen/Webbplatser/IP).
    • API-begränsningar: Begränsa nyckel -> Custom Search API.
  7. Inställningar i Siesta AI:
    • Anslutning -> Lägg till anslutning -> GoogleSearch.
    • Fyll i Key (API-nyckel) och Cx (Sökmotor-ID) och välj Delad/Privat.
    • Spara genom att klicka på Fortsätt. Inställningar för Anslutning GoogleSearch i Siesta AI

2. Syftet med dokumentet​

Målet är att möjliggöra programmatisk åtkomst till resultaten av webbsökningar via Google Custom Search JSON API.

3. Översikt över Anslutning​

  • Namn på Anslutning: GoogleSearch
  • Typ: REST API - Google Custom Search JSON API
  • Autentisering: API-nyckel (Google Cloud) + Sökmotor-ID (cx) (OAuth behövs inte)
  • Omfattning: endast read/search
  • Utdata: JSON-objekt med sökresultat
  • Obs: Det finns inga skrivoperationer; alla anrop är idempotenta.

Google Custom Search JSON API möjliggör programmatisk hämtning av sökresultat från Google via Programmable Search Engine, som måste skapas och konfigureras innan användning.

4. Allmänna principer​

4.1 Konfiguration​

  • Sökmotor-ID (cx): identifierare för din egen sökinstans.
  • API-nyckel: obligatorisk parameter för auktoriserade anrop till Google API.
  • Utdata: JSON innehåller metadata om sökningen och resultatuppsättningen (titel, utdrag, URL, pagemap osv.).

4.2 Frågesyntax​

  • Parametern query (alias q) anger sökordet.
  • Avancerade operatorer som site:, intitle: osv. kan användas (standard Google-frågesyntax).

5. API-operationer​

5.1 Sök​

Beskrivning: Utför en webbsökning via Google Custom Search JSON API.
HTTP: GET https://www.googleapis.com/customsearch/v1?key={API_KEY}&cx={SEARCH_ENGINE_ID}&q={query}

ParameterTypObligatoriskBeskrivning
querySträngJaSökord (t.ex. "AI bästa metoder").

Utdata

  • Lista över resultat (titel, URL, utdrag)
  • Metadata om antalet resultat
  • Eventuella ytterligare block (pagemap)

Beteende och begränsningar

  • Standardrespons ~10 resultat per sida; ytterligare sidor via start (utanför omfattningen av Anslutning).

Typiska fel

  • 400 Bad Request - ogiltig fråga
  • 401 Unauthorized - ogiltig API-nyckel
  • 403 Quota Exceeded - daglig kvot överskriden

6. Säkerhet och styrning​

  • Förvara API-nyckeln säkert; föredra begränsningar (domäner/IP, begränsningar till Custom Search API).
  • Övervaka kvoter och logga för fakturakontroll.
  • Logga minst: query sträng, tid för anrop, antal resultat, HTTP-status.

7. Driftsrekommendationer​

  • Ställ in en rotationspolicy för API-nyckeln (Rotate key i Google Cloud Console).
  • Håll cx och API-nyckeln i en säker secrets store; uppdatera Anslutning vid nyckeländring.

8. Exempel på användning​

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

Förkortad JSON:

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