Google Trends

Prehľad

Google Trends Connector poskytuje programový prístup k dátam služby Google Trends. Umožňuje agentom a aplikáciám získavať informácie o popularite kľúčových slov, geografickom rozložení záujmu, aktuálne trendujúcich vyhľadávaniach, súvisiacich dotazoch a návrhoch vyhľadávania.

Konektor podporuje najmä:

• historickú analýzu záujmu o kľúčové slová,
• porovnanie viacerých kľúčových slov,
• získanie aktuálne trendujúcich vyhľadávaní,
• analýzu súvisiacich tém a dotazov,
• návrhy vyhľadávania (autocomplete).

Všetky funkcie vracajú štruktúrované dáta získané z Google Trends API. U endpointov pre trendujúce vyhľadávania je implementovaný fallback na RSS zdroj, ak primárne API vráti chybu alebo neúplné dáta.

User story: Ako používateľ pridá Google Trends connector

1. Používateľ otvorí dialóg Add Connection a vyberie GoogleTrends

1. V administrácii prejde do sekcie Connections / Connected Apps.
2. Klikne na Add Connection.
3. V zozname konektorov vyberie dlaždicu GoogleTrends.

2. Používateľ vyplní detail konektora

Vo formulári Detail vyplní:

• Name: interný názov pripojenia (napr. GoogleTrends).
• Provide your ApiKey: API kľúč, nie je v danom nasadení vyžadovaný.
• Provide your Timezone: časové pásmo (napr. UTC).
• Provide your Language: jazyk odpovedí (napr. EN, CS).

3. Používateľ nastaví oprávnenia jednotlivých funkcií

Po vytvorení pripojenia nastaví u každej operácie režim volania:

• Enabled,
• Enabled with confirmation,
• Disabled.

Odporúčanie: operácie, ktoré môžu ovplyvniť beh automatizácií, nastavte minimálne na Enabled with confirmation.

4. Používateľ konektor uloží a použije

Po uložení je konektor dostupný pre agentov a workflow kroky, kde je možné volať konkrétne Google Trends funkcie podľa nastavených oprávnení.

Konfiguračné parametre konektora

Parametr	Povinný	Popis
Name	Áno	Interný názov konektora v Siesta AI
ApiKey	Podľa nasadenia	API kľúč pre prístup k službe
Timezone	Áno	Časové pásmo pre dotazy (napr. UTC)
Language	Áno	Jazyk výsledkov (napr. EN, en-US)

Podporované funkcie

1. GetInterestOverTimeAsync

Vracia vývoj záujmu o jedno alebo viac kľúčových slov v čase.

Parametr	Typ	Povinný	Popis
keywords	string	Áno	Zoznam 1-5 kľúčových slov oddelených čiarkou
timeRange	string	Nie	Časové obdobie pre analýzu
geo	string	Nie	Geografická oblasť (ISO kód krajiny)
category	int	Nie	Kategória Google Trends

Výchozie hodnoty:

• timeRange: LastThreeMonths
• geo: globálne (prázdna hodnota)
• category: 0 (všetky kategórie)

2. GetInterestByRegionAsync

Vracia rozloženie záujmu o dané kľúčové slovo podľa regiónov.

Parametr	Typ	Povinný	Popis
keyword	string	Áno	Jedno kľúčové slovo
timeRange	string	Nie	Časové obdobie
resolution	string	Nie	Úroveň geografického rozlíšenia
geo	string	Nie	Kód krajiny

Výchozie hodnoty:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Porovnáva popularitu viacerých kľúčových slov v čase.

Parametr	Typ	Povinný	Popis
keywords	string	Áno	Zoznam 2-5 kľúčových slov oddelených čiarkou
timeRange	string	Nie	Časové obdobie
geo	string	Nie	Kód krajiny

4. GetTrendingSearchesAsync

Vracia aktuálne trendujúce vyhľadávania.

Parametr	Typ	Povinný	Popis
country	string	Nie	Názov krajiny

Výchozia hodnota:

• country: united_states

Správanie:

1. Primárny pokus cez Google Trends API.
2. Pri zlyhaní fallback na RSS feed.

5. GetTodaySearchesAsync

Vracia vyhľadávania trendujúce dnes.

Parametr	Typ	Povinný	Popis
country	string	Nie	Kód krajiny

Výchozia hodnota:

• country: US

Správanie:

• Primárne API, pri zlyhaní fallback na RSS feed.

6. GetAllTrendingSearchesAsync

Vracia globálne trendujúce vyhľadávania naprieč viacerými krajinami.

Parametr	Typ	Povinný	Popis
-	-	-	Funkcia nevyžaduje parametre

Správanie:

• pokus o získanie dát cez API,
• fallback na multi-country RSS feed.

7. GetRelatedQueriesAsync

Vracia dotazy súvisiace s daným kľúčovým slovom.

Parametr	Typ	Povinný	Popis
keyword	string	Áno	Kľúčové slovo
timeRange	string	Nie	Časové obdobie
geo	string	Nie	Kód krajiny

Výstup obsahuje:

• Top queries (najčastejšie súvisiace dotazy),
• Rising queries (rýchlo rastúce dotazy).

8. GetRelatedTopicsAsync

Vracia témy súvisiace s daným kľúčovým slovom.

Parametr	Typ	Povinný	Popis
keyword	string	Áno	Kľúčové slovo
timeRange	string	Nie	Časové obdobie
geo	string	Nie	Kód krajiny

Výstup obsahuje:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Vracia návrhy vyhľadávania (autocomplete) pre zadané kľúčové slovo.

Parametr	Typ	Povinný	Popis
keyword	string	Áno	Čiastkové alebo celé kľúčové slovo

10. GetCategoriesAsync

Vracia kompletný zoznam kategórií Google Trends.

Parametr	Typ	Povinný	Popis
-	-	-	Funkcia nevyžaduje parametre

Podporované hodnoty timeRange

timeRange je case-insensitive a podporuje tieto hodnoty:

Hodnota	Popis
LastHour	posledná hodina
LastFourHours	posledné 4 hodiny
LastDay	posledných 24 hodín
LastWeek	posledných 7 dní
LastMonth	posledných 30 dní
LastThreeMonths	posledných 90 dní
LastYear	posledných 12 mesiacov
LastFiveYears	posledných 5 rokov
FromStart	všetky dostupné historické dáta

Ak je hodnota neplatná alebo chýba, použije sa výchozia hodnota LastThreeMonths.

Invocation Context

Správanie konektora môže byť ovplyvnené kontextom spustenia:

Pole	Výchozia hodnota	Popis
Language	en-US	Jazyk výsledkov
Timezone	300	Posun časového pásma v minútach

Príklad:

Language: en-US
Timezone: 300

Stratégie zdrojov dát

U endpointov pracujúcich s trendujúcimi vyhľadávaniami prebieha získanie dát v dvoch krokoch:

1. Pokus o získanie dát z Google Trends API.
2. Ak API neodpovie alebo vráti neúplné dáta, systém automaticky použije RSS feed Google Trends.

Tento mechanizmus zabezpečuje vyššiu dostupnosť dát.

Limity

Obmedzenie	Hodnota
Počet kľúčových slov v dotaze	1-5
Porovnanie kľúčových slov	2-5
Výchozie časové obdobie	LastThreeMonths

Shrnutie

Google Trends connector je vhodný pre analytické use-cases, monitoring tém, marketingové workflow a porovnávanie trendov v čase. Poskytuje jednotné rozhranie pre prácu s dátami Google Trends, vrátane fallback stratégie pre trendujúce vyhľadávania.