Google Trends

Översikt

Google Trends Connector ger programmatisk åtkomst till data från Google Trends. Det gör det möjligt för agenter och applikationer att hämta information om populariteten av sökord, geografisk fördelning av intresse, aktuella trendande sökningar, relaterade frågor och sökförslag.

Kopplingen stöder särskilt:

• historisk analys av intresset för sökord,
• jämförelse av flera sökord,
• hämtning av aktuella trendande sökningar,
• analys av relaterade ämnen och frågor,
• sökförslag (autocomplete).

Alla funktioner returnerar strukturerade data som erhållits från Google Trends API. För endpointar för trendande sökningar har en fallback till RSS-källa implementerats om det primära API:et returnerar ett fel eller ofullständiga data.

Användarberättelse: Hur en användare lägger till Google Trends-kopplingen

1. Användaren öppnar dialogrutan Lägg till anslutning och väljer GoogleTrends

1. I administrationen går de till sektionen Connections / Connected Apps.
2. Klickar på Add Connection.
3. I listan över kopplingar väljer de rutan GoogleTrends.

2. Användaren fyller i kopplingens detaljer

I formuläret Detalj fyller de i:

• Name: internt namn på anslutningen (t.ex. GoogleTrends).
• Provide your ApiKey: API-nyckel, krävs inte i den aktuella distributionen.
• Provide your Timezone: tidszon (t.ex. UTC).
• Provide your Language: språk för svar (t.ex. EN, CS).

3. Användaren ställer in behörigheter för de olika funktionerna

Efter att ha skapat anslutningen ställer de in anropsläget för varje operation:

• Enabled,
• Enabled with confirmation,
• Disabled.

Rekommendation: operationer som kan påverka körningen av automatiseringar bör ställas in på minst Enabled with confirmation.

4. Användaren sparar och använder kopplingen

Efter att ha sparat är kopplingen tillgänglig för agenter och arbetsflödessteg, där specifika Google Trends-funktioner kan anropas enligt de inställda behörigheterna.

Konfigurationsparametrar för kopplingen

Parameter	Obligatorisk	Beskrivning
Name	Ja	Internt namn på kopplingen i Siesta AI
ApiKey	Beroende på distribution	API-nyckel för åtkomst till tjänsten
Timezone	Ja	Tidszon för frågor (t.ex. UTC)
Language	Ja	Språk för resultaten (t.ex. EN, en-US)

Stödda funktioner

1. GetInterestOverTimeAsync

Returnerar utvecklingen av intresset för ett eller flera sökord över tid.

Parameter	Typ	Obligatorisk	Beskrivning
keywords	string	Ja	Lista med 1-5 sökord separerade med kommatecken
timeRange	string	Nej	Tidsperiod för analys
geo	string	Nej	Geografiskt område (ISO-kod för land)
category	int	Nej	Kategori för Google Trends

Standardvärden:

• timeRange: LastThreeMonths
• geo: globalt (tomt värde)
• category: 0 (alla kategorier)

2. GetInterestByRegionAsync

Returnerar fördelningen av intresset för ett givet sökord efter regioner.

Parameter	Typ	Obligatorisk	Beskrivning
keyword	string	Ja	Ett sökord
timeRange	string	Nej	Tidsperiod
resolution	string	Nej	Nivå av geografisk upplösning
geo	string	Nej	Landskod

Standardvärden:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Jämför populariteten av flera sökord över tid.

Parameter	Typ	Obligatorisk	Beskrivning
keywords	string	Ja	Lista med 2-5 sökord separerade med kommatecken
timeRange	string	Nej	Tidsperiod
geo	string	Nej	Landskod

4. GetTrendingSearchesAsync

Returnerar aktuellt trendande sökningar.

Parameter	Typ	Obligatorisk	Beskrivning
country	string	Nej	Landsnamn

Standardvärde:

• country: united_states

Beteende:

1. Primärt försök via Google Trends API.
2. Vid misslyckande fallback till RSS-flöde.

5. GetTodaySearchesAsync

Returnerar sökningar som trendar idag.

Parameter	Typ	Obligatorisk	Beskrivning
country	string	Nej	Landskod

Standardvärde:

• country: US

Beteende:

• Primärt API, vid misslyckande fallback till RSS-flöde.

6. GetAllTrendingSearchesAsync

Returnerar globalt trendande sökningar över flera länder.

Parameter	Typ	Obligatorisk	Beskrivning
-	-	-	Funktionen kräver inga parametrar

Beteende:

• försök att hämta data via API,
• fallback till multi-country RSS-flöde.

7. GetRelatedQueriesAsync

Returnerar frågor relaterade till ett givet sökord.

Parameter	Typ	Obligatorisk	Beskrivning
keyword	string	Ja	Sökord
timeRange	string	Nej	Tidsperiod
geo	string	Nej	Landskod

Utdata innehåller:

• Top queries (de mest frekventa relaterade frågorna),
• Rising queries (snabbt växande frågor).

8. GetRelatedTopicsAsync

Returnerar ämnen relaterade till ett givet sökord.

Parameter	Typ	Obligatorisk	Beskrivning
keyword	string	Ja	Sökord
timeRange	string	Nej	Tidsperiod
geo	string	Nej	Landskod

Utdata innehåller:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Returnerar sökförslag (autocomplete) för det angivna sökordet.

Parameter	Typ	Obligatorisk	Beskrivning
keyword	string	Ja	Delvis eller helt sökord

10. GetCategoriesAsync

Returnerar en komplett lista över kategorier för Google Trends.

Parameter	Typ	Obligatorisk	Beskrivning
-	-	-	Funktionen kräver inga parametrar

Stödda värden för timeRange

timeRange är skiftlägeskänsligt och stöder följande värden:

Värde	Beskrivning
LastHour	senaste timmen
LastFourHours	senaste 4 timmarna
LastDay	senaste 24 timmarna
LastWeek	senaste 7 dagarna
LastMonth	senaste 30 dagarna
LastThreeMonths	senaste 90 dagarna
LastYear	senaste 12 månaderna
LastFiveYears	senaste 5 åren
FromStart	alla tillgängliga historiska data

Om värdet är ogiltigt eller saknas används standardvärdet LastThreeMonths.

Anropskontext

Beteendet hos kopplingen kan påverkas av körningskontexten:

Fält	Standardvärde	Beskrivning
Language	en-US	Språk för resultaten
Timezone	300	Tidszonsförskjutning i minuter

Exempel:

Language: en-US
Timezone: 300

Strategi för datakällor

För endpointar som arbetar med trendande sökningar sker datainsamlingen i två steg:

1. Försök att hämta data från Google Trends API.
2. Om API:et inte svarar eller returnerar ofullständiga data, använder systemet automatiskt Google Trends RSS-flöde.

Denna mekanism säkerställer högre tillgänglighet av data.

Begränsningar

Begränsning	Värde
Antal sökord i frågan	1-5
Jämförelse av sökord	2-5
Standard tidsperiod	LastThreeMonths

Sammanfattning

Google Trends-kopplingen är lämplig för analytiska användningsfall, övervakning av ämnen, marknadsföringsarbetsflöden och jämförelse av trender över tid. Den tillhandahåller ett enhetligt gränssnitt för att arbeta med data från Google Trends, inklusive fallback-strategi för trendande sökningar.