Google Trends

Oversigt

Google Trends Connector giver programmatisk adgang til data fra Google Trends. Det gør det muligt for agenter og applikationer at hente information om populariteten af søgeord, geografisk fordeling af interesse, aktuelt trending søgninger, relaterede forespørgsler og søgeforslag.

Konnektoren understøtter især:

• historisk analyse af interesse for søgeord,
• sammenligning af flere søgeord,
• hentning af aktuelt trending søgninger,
• analyse af relaterede emner og forespørgsler,
• søgeforslag (autocomplete).

Alle funktioner returnerer strukturerede data hentet fra Google Trends API. For endpoints til trending søgninger er der implementeret en fallback til RSS-kilde, hvis det primære API returnerer en fejl eller ufuldstændige data.

Brugerhistorie: Hvordan en bruger tilføjer Google Trends connector

1. Brugeren åbner dialogen Tilføj forbindelse og vælger GoogleTrends

1. I administrationen går de til sektionen Connections / Connected Apps.
2. Klikker på Add Connection.
3. I listen over konnektorer vælger de flisen GoogleTrends.

2. Brugeren udfylder detaljerne for konnektoren

I formularen Detail udfylder de:

• Name: internt navn på forbindelsen (f.eks. GoogleTrends).
• Provide your ApiKey: API-nøgle, ikke påkrævet i denne implementering.
• Provide your Timezone: tidszone (f.eks. UTC).
• Provide your Language: sprog for svar (f.eks. EN, CS).

3. Brugeren indstiller tilladelser for de enkelte funktioner

Efter oprettelsen af forbindelsen indstiller de for hver operation kaldemodus:

• Enabled,
• Enabled with confirmation,
• Disabled.

Anbefaling: operationer, der kan påvirke kørsel af automatiseringer, indstilles mindst til Enabled with confirmation.

4. Brugeren gemmer og bruger konnektoren

Efter gemmelsen er konnektoren tilgængelig for agenter og workflow-trin, hvor specifikke Google Trends-funktioner kan kaldes i henhold til de indstillede tilladelser.

Konfigurationsparametre for konnektoren

Parameter	Påkrævet	Beskrivelse
Name	Ja	Internt navn på konnektoren i Siesta AI
ApiKey	Afhængig af implementering	API-nøgle til adgang til tjenesten
Timezone	Ja	Tidszone for forespørgsler (f.eks. UTC)
Language	Ja	Sprog for resultater (f.eks. EN, en-US)

Understøttede funktioner

1. GetInterestOverTimeAsync

Returnerer udviklingen af interesse for et eller flere søgeord over tid.

Parameter	Type	Påkrævet	Beskrivelse
keywords	string	Ja	Liste over 1-5 søgeord adskilt af komma
timeRange	string	Nej	Tidsperiode for analysen
geo	string	Nej	Geografisk område (ISO landekode)
category	int	Nej	Kategori for Google Trends

Standardværdier:

• timeRange: LastThreeMonths
• geo: globalt (tom værdi)
• category: 0 (alle kategorier)

2. GetInterestByRegionAsync

Returnerer fordelingen af interesse for et givet søgeord efter regioner.

Parameter	Type	Påkrævet	Beskrivelse
keyword	string	Ja	Et enkelt søgeord
timeRange	string	Nej	Tidsperiode
resolution	string	Nej	Niveau for geografisk opløsning
geo	string	Nej	Landekode

Standardværdier:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Sammenligner populariteten af flere søgeord over tid.

Parameter	Type	Påkrævet	Beskrivelse
keywords	string	Ja	Liste over 2-5 søgeord adskilt af komma
timeRange	string	Nej	Tidsperiode
geo	string	Nej	Landekode

4. GetTrendingSearchesAsync

Returnerer aktuelt trending søgninger.

Parameter	Type	Påkrævet	Beskrivelse
country	string	Nej	Navn på landet

Standardværdi:

• country: united_states

Adfærd:

1. Primært forsøg via Google Trends API.
2. Ved fejl fallback til RSS-feed.

5. GetTodaySearchesAsync

Returnerer søgninger, der trender i dag.

Parameter	Type	Påkrævet	Beskrivelse
country	string	Nej	Landekode

Standardværdi:

• country: US

Adfærd:

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

6. GetAllTrendingSearchesAsync

Returnerer globalt trending søgninger på tværs af flere lande.

Parameter	Type	Påkrævet	Beskrivelse
-	-	-	Funktionen kræver ikke parametre

Adfærd:

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

7. GetRelatedQueriesAsync

Returnerer forespørgsler relateret til et givet søgeord.

Parameter	Type	Påkrævet	Beskrivelse
keyword	string	Ja	Søgeord
timeRange	string	Nej	Tidsperiode
geo	string	Nej	Landekode

Outputtet indeholder:

• Top queries (de mest almindelige relaterede forespørgsler),
• Rising queries (hurtigt voksende forespørgsler).

8. GetRelatedTopicsAsync

Returnerer emner relateret til et givet søgeord.

Parameter	Type	Påkrævet	Beskrivelse
keyword	string	Ja	Søgeord
timeRange	string	Nej	Tidsperiode
geo	string	Nej	Landekode

Outputtet indeholder:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Returnerer søgeforslag (autocomplete) for det angivne søgeord.

Parameter	Type	Påkrævet	Beskrivelse
keyword	string	Ja	Delvist eller helt søgeord

10. GetCategoriesAsync

Returnerer en komplet liste over kategorier i Google Trends.

Parameter	Type	Påkrævet	Beskrivelse
-	-	-	Funktionen kræver ikke parametre

Understøttede værdier for timeRange

timeRange er case-insensitive og understøtter følgende værdier:

Værdi	Beskrivelse
LastHour	sidste time
LastFourHours	sidste 4 timer
LastDay	sidste 24 timer
LastWeek	sidste 7 dage
LastMonth	sidste 30 dage
LastThreeMonths	sidste 90 dage
LastYear	sidste 12 måneder
LastFiveYears	sidste 5 år
FromStart	alle tilgængelige historiske data

Hvis værdien er ugyldig eller mangler, anvendes standardværdien LastThreeMonths.

Invocation Context

Adfærden for konnektoren kan påvirkes af konteksten for udførelsen:

Felt	Standardværdi	Beskrivelse
Language	en-US	Sprog for resultater
Timezone	300	Tidszoneforskydning i minutter

Eksempel:

Language: en-US
Timezone: 300

Strategi for datakilder

For endpoints, der arbejder med trending søgninger, sker dataindsamlingen i to trin:

1. Forsøg på at hente data fra Google Trends API.
2. Hvis API ikke svarer eller returnerer ufuldstændige data, bruger systemet automatisk Google Trends RSS-feed.

Denne mekanisme sikrer højere tilgængelighed af data.

Grænser

Begrænsning	Værdi
Antal søgeord i forespørgslen	1-5
Sammenligning af søgeord	2-5
Standard tidsperiode	LastThreeMonths

Resumé

Google Trends connector er velegnet til analytiske use-cases, overvågning af emner, marketing workflows og sammenligning af trends over tid. Den giver et ensartet interface til at arbejde med data fra Google Trends, inklusive fallback-strategi for trending søgninger.