Google Trends

Übersicht

Der Google Trends Connector bietet programmgesteuerten Zugriff auf die Daten von Google Trends. Er ermöglicht Agenten und Anwendungen, Informationen über die Popularität von Schlüsselwörtern, die geografische Verteilung des Interesses, aktuell trendende Suchanfragen, verwandte Anfragen und Suchvorschläge zu erhalten.

Der Connector unterstützt insbesondere:

• historische Analysen des Interesses an Schlüsselwörtern,
• den Vergleich mehrerer Schlüsselwörter,
• den Abruf aktuell trendender Suchanfragen,
• die Analyse verwandter Themen und Anfragen,
• Suchvorschläge (Autocomplete).

Alle Funktionen geben strukturierte Daten zurück, die über die Google Trends API abgerufen werden. Bei Endpunkten für trendende Suchanfragen ist ein Fallback auf einen RSS-Feed implementiert, falls die primäre API einen Fehler oder unvollständige Daten zurückgibt.

User Story: Wie ein Benutzer den Google Trends Connector hinzufügt

1. Benutzer öffnet den Dialog "Verbindung hinzufügen" und wählt GoogleTrends

1. In der Verwaltung wechselt er zum Abschnitt Connections / Connected Apps.
2. Er klickt auf Add Connection.
3. Im Connectoren-Verzeichnis wählt er die Kachel GoogleTrends.

2. Benutzer füllt die Details des Connectors aus

Im Formular Detail füllt er aus:

• Name: interner Name der Verbindung (z.B. GoogleTrends).
• Provide your ApiKey: API-Schlüssel, der in dieser Bereitstellung nicht erforderlich ist.
• Provide your Timezone: Zeitzone (z.B. UTC).
• Provide your Language: Sprache der Antworten (z.B. EN, CS).

3. Benutzer legt die Berechtigungen für die einzelnen Funktionen fest

Nach der Erstellung der Verbindung legt er für jede Operation den Aufrufmodus fest:

• Enabled,
• Enabled with confirmation,
• Disabled.

Empfehlung: Stellen Sie Operationen, die den Ablauf von Automatisierungen beeinflussen können, mindestens auf Enabled with confirmation.

4. Benutzer speichert den Connector und verwendet ihn

Nach dem Speichern ist der Connector für Agenten und Workflow-Schritte verfügbar, wo spezifische Google Trends-Funktionen gemäß den festgelegten Berechtigungen aufgerufen werden können.

Konfigurationsparameter des Connectors

Parameter	Pflichtfeld	Beschreibung
Name	Ja	Interner Name des Connectors in Siesta AI
ApiKey	Je nach Bereitstellung	API-Schlüssel für den Zugriff auf den Dienst
Timezone	Ja	Zeitzone für Anfragen (z.B. UTC)
Language	Ja	Sprache der Ergebnisse (z.B. EN, en-US)

Unterstützte Funktionen

1. GetInterestOverTimeAsync

Gibt die Entwicklung des Interesses an einem oder mehreren Schlüsselwörtern im Zeitverlauf zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
keywords	string	Ja	Liste von 1-5 Schlüsselwörtern, durch Kommas getrennt
timeRange	string	Nein	Zeitraum für die Analyse
geo	string	Nein	Geografisches Gebiet (ISO-Ländercode)
category	int	Nein	Kategorie von Google Trends

Standardwerte:

• timeRange: LastThreeMonths
• geo: global (leerer Wert)
• category: 0 (alle Kategorien)

2. GetInterestByRegionAsync

Gibt die Verteilung des Interesses an einem bestimmten Schlüsselwort nach Regionen zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
keyword	string	Ja	Ein einzelnes Schlüsselwort
timeRange	string	Nein	Zeitraum
resolution	string	Nein	Ebene der geografischen Auflösung
geo	string	Nein	Ländercode

Standardwerte:

• resolution: COUNTRY
• geo: US

3. CompareKeywordsAsync

Vergleicht die Popularität mehrerer Schlüsselwörter im Zeitverlauf.

Parameter	Typ	Pflichtfeld	Beschreibung
keywords	string	Ja	Liste von 2-5 Schlüsselwörtern, durch Kommas getrennt
timeRange	string	Nein	Zeitraum
geo	string	Nein	Ländercode

4. GetTrendingSearchesAsync

Gibt aktuell trendende Suchanfragen zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
country	string	Nein	Name des Landes

Standardwert:

• country: united_states

Verhalten:

1. Primärer Versuch über die Google Trends API.
2. Bei einem Fehler Fallback auf den RSS-Feed.

5. GetTodaySearchesAsync

Gibt Suchanfragen zurück, die heute im Trend liegen.

Parameter	Typ	Pflichtfeld	Beschreibung
country	string	Nein	Ländercode

Standardwert:

• country: US

Verhalten:

• Primär API, bei einem Fehler Fallback auf den RSS-Feed.

6. GetAllTrendingSearchesAsync

Gibt global trendende Suchanfragen über mehrere Länder zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
-	-	-	Funktion erfordert keine Parameter

Verhalten:

• Versuch, Daten über die API abzurufen,
• Fallback auf den Multi-Country RSS-Feed.

7. GetRelatedQueriesAsync

Gibt Anfragen zurück, die mit einem bestimmten Schlüsselwort verbunden sind.

Parameter	Typ	Pflichtfeld	Beschreibung
keyword	string	Ja	Schlüsselwort
timeRange	string	Nein	Zeitraum
geo	string	Nein	Ländercode

Die Ausgabe enthält:

• Top queries (häufigste verwandte Anfragen),
• Rising queries (schnell wachsende Anfragen).

8. GetRelatedTopicsAsync

Gibt Themen zurück, die mit einem bestimmten Schlüsselwort verbunden sind.

Parameter	Typ	Pflichtfeld	Beschreibung
keyword	string	Ja	Schlüsselwort
timeRange	string	Nein	Zeitraum
geo	string	Nein	Ländercode

Die Ausgabe enthält:

• Top topics,
• Rising topics.

9. GetSuggestionsAsync

Gibt Suchvorschläge (Autocomplete) für ein angegebenes Schlüsselwort zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
keyword	string	Ja	Teil- oder vollständiges Schlüsselwort

10. GetCategoriesAsync

Gibt eine vollständige Liste der Kategorien von Google Trends zurück.

Parameter	Typ	Pflichtfeld	Beschreibung
-	-	-	Funktion erfordert keine Parameter

Unterstützte Werte für timeRange

timeRange ist nicht case-sensitiv und unterstützt die folgenden Werte:

Wert	Beschreibung
LastHour	letzte Stunde
LastFourHours	letzte 4 Stunden
LastDay	letzte 24 Stunden
LastWeek	letzte 7 Tage
LastMonth	letzte 30 Tage
LastThreeMonths	letzte 90 Tage
LastYear	letzte 12 Monate
LastFiveYears	letzte 5 Jahre
FromStart	alle verfügbaren historischen Daten

Wenn der Wert ungültig oder fehlt, wird der Standardwert LastThreeMonths verwendet.

Invocation Context

Das Verhalten des Connectors kann durch den Ausführungskontext beeinflusst werden:

Feld	Standardwert	Beschreibung
Language	en-US	Sprache der Ergebnisse
Timezone	300	Zeitverschiebung in Minuten

Beispiel:

Language: en-US
Timezone: 300

Datenquelle-Strategien

Bei Endpunkten, die mit trendenden Suchanfragen arbeiten, erfolgt der Datenabruf in zwei Schritten:

1. Versuch, Daten von der Google Trends API abzurufen.
2. Wenn die API nicht antwortet oder unvollständige Daten zurückgibt, verwendet das System automatisch den RSS-Feed von Google Trends.

Dieser Mechanismus gewährleistet eine höhere Verfügbarkeit der Daten.

Limits

Einschränkung	Wert
Anzahl der Schlüsselwörter in der Anfrage	1-5
Vergleich von Schlüsselwörtern	2-5
Standardzeitraum	LastThreeMonths

Zusammenfassung

Der Google Trends Connector eignet sich für analytische Anwendungsfälle, Themenüberwachung, Marketing-Workflows und den Vergleich von Trends über die Zeit. Er bietet eine einheitliche Schnittstelle für die Arbeit mit Daten von Google Trends, einschließlich einer Fallback-Strategie für trendende Suchanfragen.