Google Trends

Přehled

Google Trends Connector poskytuje programový přístup k datům služby Google Trends. Umožňuje agentům a aplikacím získávat informace o popularitě klíčových slov, geografickém rozložení zájmu, aktuálně trendujících vyhledáváních, souvisejících dotazech a návrzích vyhledávání.

Konektor podporuje zejména:

• historickou analýzu zájmu o klíčová slova,
• porovnání více klíčových slov,
• získání aktuálně trendujících vyhledávání,
• analýzu souvisejících témat a dotazů,
• návrhy vyhledávání (autocomplete).

Všechny funkce vracejí strukturovaná data získaná z Google Trends API. U endpointů pro trendující vyhledávání je implementován fallback na RSS zdroj, pokud primární API vrátí chybu nebo neúplná data.

User story: Jak uživatel přidá Google Trends connector

1. Uživatel otevře dialog Add Connection a vybere GoogleTrends

1. V administraci přejde do sekce Connections / Connected Apps.
2. Klikne na Add Connection.
3. V seznamu konektorů vybere dlaždici GoogleTrends.

2. Uživatel vyplní detail konektoru

Ve formuláři Detail vyplní:

• Name: interní název připojení (např. GoogleTrends).
• Provide your ApiKey: API klíč, není v daném nasazení vyžadován.
• Provide your Timezone: časové pásmo (např. UTC).
• Provide your Language: jazyk odpovědí (např. EN, CS).

3. Uživatel nastaví oprávnění jednotlivých funkcí

Po vytvoření připojení nastaví u každé operace režim volání:

• Enabled,
• Enabled with confirmation,
• Disabled.

Doporučení: operace, které mohou ovlivnit běh automatizací, nastavte minimálně na Enabled with confirmation.

4. Uživatel konektor uloží a použije

Po uložení je konektor dostupný pro agenty a workflow kroky, kde lze volat konkrétní Google Trends funkce podle nastavených oprávnění.

Konfigurační parametry konektoru

Parametr	Povinný	Popis
Name	Ano	Interní název konektoru v Siesta AI
ApiKey	Dle nasazení	API klíč pro přístup ke službě
Timezone	Ano	Časové pásmo pro dotazy (např. UTC)
Language	Ano	Jazyk výsledků (např. EN, en-US)

Podporované funkce

1. GetInterestOverTimeAsync

Vrací vývoj zájmu o jedno nebo více klíčových slov v čase.

Parametr	Typ	Povinný	Popis
keywords	string	Ano	Seznam 1-5 klíčových slov oddělených čárkou
timeRange	string	Ne	Časové období pro analýzu
geo	string	Ne	Geografická oblast (ISO kód země)
category	int	Ne	Kategorie Google Trends

Výchozí hodnoty:

• timeRange: LastThreeMonths
• geo: globálně (prázdná hodnota)
• category: 0 (všechny kategorie)

2. GetInterestByRegionAsync

Vrací rozložení zájmu o dané klíčové slovo podle regionů.

Parametr	Typ	Povinný	Popis
keyword	string	Ano	Jedno klíčové slovo
timeRange	string	Ne	Časové období
resolution	string	Ne	Úroveň geografického rozlišení
geo	string	Ne	Kód země

Výchozí hodnoty:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Porovnává popularitu více klíčových slov v čase.

Parametr	Typ	Povinný	Popis
keywords	string	Ano	Seznam 2-5 klíčových slov oddělených čárkou
timeRange	string	Ne	Časové období
geo	string	Ne	Kód země

4. GetTrendingSearchesAsync

Vrací aktuálně trendující vyhledávání.

Parametr	Typ	Povinný	Popis
country	string	Ne	Název země

Výchozí hodnota:

• country: united_states

Chování:

1. Primární pokus přes Google Trends API.
2. Při selhání fallback na RSS feed.

5. GetTodaySearchesAsync

Vrací vyhledávání trendující dnes.

Parametr	Typ	Povinný	Popis
country	string	Ne	Kód země

Výchozí hodnota:

• country: US

Chování:

• Primárně API, při selhání fallback na RSS feed.

6. GetAllTrendingSearchesAsync

Vrací globálně trendující vyhledávání napříč více zeměmi.

Parametr	Typ	Povinný	Popis
-	-	-	Funkce nevyžaduje parametry

Chování:

• pokus o získání dat přes API,
• fallback na multi-country RSS feed.

7. GetRelatedQueriesAsync

Vrací dotazy související s daným klíčovým slovem.

Parametr	Typ	Povinný	Popis
keyword	string	Ano	Klíčové slovo
timeRange	string	Ne	Časové období
geo	string	Ne	Kód země

Výstup obsahuje:

• Top queries (nejčastější související dotazy),
• Rising queries (rychle rostoucí dotazy).

8. GetRelatedTopicsAsync

Vrací témata související s daným klíčovým slovem.

Parametr	Typ	Povinný	Popis
keyword	string	Ano	Klíčové slovo
timeRange	string	Ne	Časové období
geo	string	Ne	Kód země

Výstup obsahuje:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Vrací návrhy vyhledávání (autocomplete) pro zadané klíčové slovo.

Parametr	Typ	Povinný	Popis
keyword	string	Ano	Částečné nebo celé klíčové slovo

10. GetCategoriesAsync

Vrací kompletní seznam kategorií Google Trends.

Parametr	Typ	Povinný	Popis
-	-	-	Funkce nevyžaduje parametry

Podporované hodnoty timeRange

timeRange je case-insensitive a podporuje tyto hodnoty:

Hodnota	Popis
LastHour	poslední hodina
LastFourHours	poslední 4 hodiny
LastDay	posledních 24 hodin
LastWeek	posledních 7 dní
LastMonth	posledních 30 dní
LastThreeMonths	posledních 90 dní
LastYear	posledních 12 měsíců
LastFiveYears	posledních 5 let
FromStart	všechna dostupná historická data

Pokud je hodnota neplatná nebo chybí, použije se výchozí hodnota LastThreeMonths.

Invocation Context

Chování konektoru může být ovlivněno kontextem spuštění:

Pole	Výchozí hodnota	Popis
Language	en-US	Jazyk výsledků
Timezone	300	Posun časového pásma v minutách

Příklad:

Language: en-US
Timezone: 300

Strategie zdrojů dat

U endpointů pracujících s trendujícími vyhledáváními probíhá získání dat ve dvou krocích:

1. Pokus o získání dat z Google Trends API.
2. Pokud API neodpoví nebo vrátí neúplná data, systém automaticky použije RSS feed Google Trends.

Tento mechanismus zajišťuje vyšší dostupnost dat.

Limity

Omezení	Hodnota
Počet klíčových slov v dotazu	1-5
Porovnání klíčových slov	2-5
Výchozí časové období	LastThreeMonths

Shrnutí

Google Trends connector je vhodný pro analytické use-cases, monitoring témat, marketingové workflow a porovnávání trendů v čase. Poskytuje jednotné rozhraní pro práci s daty Google Trends, včetně fallback strategie pro trendující vyhledávání.