Google Trends

Oversikt

Google Trends Connector gir programmatisk tilgang til data fra Google Trends. Det lar agenter og applikasjoner hente informasjon om populariteten til søkeord, geografisk fordeling av interesse, nåværende trendende søk, relaterte forespørsel og søkeforslag.

Konnektoren støtter spesielt:

• historisk analyse av interesse for søkeord,
• sammenligning av flere søkeord,
• innhenting av nåværende trendende søk,
• analyse av relaterte emner og forespørsel,
• søkeforslag (autocomplete).

Alle funksjoner returnerer strukturerte data hentet fra Google Trends API. For endepunktene for trendende søk er det implementert en fallback til RSS-kilde, hvis primær-API-en returnerer en feil eller ufullstendige data.

Brukerhistorie: Hvordan en bruker legger til Google Trends-konnektoren

1. Brukeren åpner dialogen Legg til tilkobling og velger GoogleTrends

1. I administrasjonen går de til seksjonen Connections / Connected Apps.
2. Klikker på Add Connection.
3. I listen over konnektorer velger de flisen GoogleTrends.

2. Brukeren fyller ut detaljene for konnektoren

I skjemaet Detail fyller de ut:

• Name: intern navn på tilkoblingen (f.eks. GoogleTrends).
• Provide your ApiKey: API-nøkkel, ikke påkrevd i denne distribusjonen.
• Provide your Timezone: tidssone (f.eks. UTC).
• Provide your Language: språk for svar (f.eks. EN, CS).

3. Brukeren setter tillatelser for de enkelte funksjonene

Etter å ha opprettet tilkoblingen, setter de for hver operasjon anropsmodus:

• Enabled,
• Enabled with confirmation,
• Disabled.

Anbefaling: operasjoner som kan påvirke kjøringen av automatiseringer, bør settes til minst Enabled with confirmation.

4. Brukeren lagrer og bruker konnektoren

Etter lagring er konnektoren tilgjengelig for agenter og arbeidsflyttrinn, hvor spesifikke Google Trends-funksjoner kan kalles i henhold til de angitte tillatelsene.

Konfigurasjonsparametere for konnektoren

Parameter	Obligatorisk	Beskrivelse
Name	Ja	Intern navn på konnektoren i Siesta AI
ApiKey	Avhengig av distribusjon	API-nøkkel for tilgang til tjenesten
Timezone	Ja	Tidssone for forespørsel (f.eks. UTC)
Language	Ja	Språk for resultater (f.eks. EN, en-US)

Støttede funksjoner

1. GetInterestOverTimeAsync

Returnerer utviklingen av interessen for ett eller flere søkeord over tid.

Parameter	Type	Obligatorisk	Beskrivelse
keywords	string	Ja	Liste over 1-5 søkeord separert med komma
timeRange	string	Nei	Tidsperiode for analysen
geo	string	Nei	Geografisk område (ISO-kode for land)
category	int	Nei	Kategori for Google Trends

Standardverdier:

• timeRange: LastThreeMonths
• geo: globalt (tom verdi)
• category: 0 (alle kategorier)

2. GetInterestByRegionAsync

Returnerer fordelingen av interessen for et gitt søkeord etter regioner.

Parameter	Type	Obligatorisk	Beskrivelse
keyword	string	Ja	Ett søkeord
timeRange	string	Nei	Tidsperiode
resolution	string	Nei	Nivå av geografisk oppløsning
geo	string	Nei	Landskode

Standardverdier:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Sammenligner populariteten til flere søkeord over tid.

Parameter	Type	Obligatorisk	Beskrivelse
keywords	string	Ja	Liste over 2-5 søkeord separert med komma
timeRange	string	Nei	Tidsperiode
geo	string	Nei	Landskode

4. GetTrendingSearchesAsync

Returnerer nåværende trendende søk.

Parameter	Type	Obligatorisk	Beskrivelse
country	string	Nei	Navn på landet

Standardverdi:

• country: united_states

Atferd:

1. Primært forsøk gjennom Google Trends API.
2. Ved feil fallback til RSS-feed.

5. GetTodaySearchesAsync

Returnerer søk som trender i dag.

Parameter	Type	Obligatorisk	Beskrivelse
country	string	Nei	Landskode

Standardverdi:

• country: US

Atferd:

• Primært API, ved feil fallback til RSS-feed.

6. GetAllTrendingSearchesAsync

Returnerer globalt trendende søk på tvers av flere land.

Parameter	Type	Obligatorisk	Beskrivelse
-	-	-	Funksjonen krever ingen parametere

Atferd:

• forsøk på å hente data via API,
• fallback til multi-country RSS-feed.

7. GetRelatedQueriesAsync

Returnerer forespørsel relatert til et gitt søkeord.

Parameter	Type	Obligatorisk	Beskrivelse
keyword	string	Ja	Søkeord
timeRange	string	Nei	Tidsperiode
geo	string	Nei	Landskode

Utdataene inneholder:

• Top queries (de mest vanlige relaterte forespørslene),
• Rising queries (raskt voksende forespørsel).

8. GetRelatedTopicsAsync

Returnerer emner relatert til et gitt søkeord.

Parameter	Type	Obligatorisk	Beskrivelse
keyword	string	Ja	Søkeord
timeRange	string	Nei	Tidsperiode
geo	string	Nei	Landskode

Utdataene inneholder:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Returnerer søkeforslag (autocomplete) for det angitte søkeordet.

Parameter	Type	Obligatorisk	Beskrivelse
keyword	string	Ja	Delvis eller helt søkeord

10. GetCategoriesAsync

Returnerer en komplett liste over kategorier for Google Trends.

Parameter	Type	Obligatorisk	Beskrivelse
-	-	-	Funksjonen krever ingen parametere

Støttede verdier for timeRange

timeRange er case-insensitive og støtter følgende verdier:

Verdi	Beskrivelse
LastHour	siste time
LastFourHours	siste 4 timer
LastDay	siste 24 timer
LastWeek	siste 7 dager
LastMonth	siste 30 dager
LastThreeMonths	siste 90 dager
LastYear	siste 12 måneder
LastFiveYears	siste 5 år
FromStart	alle tilgjengelige historiske data

Hvis verdien er ugyldig eller mangler, brukes standardverdien LastThreeMonths.

Invokasjonskontekst

Atferden til konnektoren kan påvirkes av kjøringskonteksten:

Felt	Standardverdi	Beskrivelse
Language	en-US	Språk for resultater
Timezone	300	Tidssoneforskyvning i minutter

Eksempel:

Language: en-US
Timezone: 300

Strategi for datakilder

For endepunktene som arbeider med trendende søk, skjer innhenting av data i to trinn:

1. Forsøk på å hente data fra Google Trends API.
2. Hvis API-en ikke svarer eller returnerer ufullstendige data, bruker systemet automatisk Google Trends RSS-feed.

Denne mekanismen sikrer høyere tilgjengelighet av data.

Begrensninger

Begrensning	Verdi
Antall søkeord i forespørselen	1-5
Sammenligning av søkeord	2-5
Standard tidsperiode	LastThreeMonths

Oppsummering

Google Trends-konnektoren er egnet for analytiske bruksområder, overvåking av emner, markedsføringsarbeidsflyt og sammenligning av trender over tid. Den gir et enhetlig grensesnitt for å arbeide med data fra Google Trends, inkludert fallback-strategi for trendende søk.