Google Trends
Aperçu
Le connecteur Google Trends fournit un accès programmatique aux données du service Google Trends. Il permet aux agents et aux applications d'obtenir des informations sur la popularité des mots-clés, la répartition géographique de l'intérêt, les recherches actuellement tendance, les requêtes associées et les suggestions de recherche.
Le connecteur prend principalement en charge :
- l'analyse historique de l'intérêt pour les mots-clés,
- la comparaison de plusieurs mots-clés,
- l'obtention des recherches actuellement tendance,
- l'analyse des sujets et des requêtes associés,
- les suggestions de recherche (autocomplete).
Toutes les fonctionnalités renvoient des données structurées obtenues à partir de l'API Google Trends. Pour les points de terminaison des recherches tendance, un fallback sur une source RSS est mis en œuvre si l'API principale renvoie une erreur ou des données incomplètes.
User story : Comment un utilisateur ajoute le connecteur Google Trends
1. L'utilisateur ouvre la boîte de dialogue Ajouter une connexion et sélectionne GoogleTrends
- Dans l'administration, il se rend dans la section Connections / Connected Apps.
- Il clique sur Add Connection.
- Dans la liste des connecteurs, il sélectionne la tuile GoogleTrends.
2. L'utilisateur remplit les détails du connecteur
Dans le formulaire Détails, il remplit :
- Name : nom interne de la connexion (par exemple,
GoogleTrends). - Provide your ApiKey : clé API, non requise dans cette mise en œuvre.
- Provide your Timezone : fuseau horaire (par exemple,
UTC). - Provide your Language : langue des réponses (par exemple,
EN, CS).
3. L'utilisateur définit les autorisations des différentes fonctionnalités
Après avoir créé la connexion, il définit pour chaque opération le mode d'appel :
- Enabled,
- Enabled with confirmation,
- Disabled.
Recommandation : pour les opérations qui peuvent affecter le fonctionnement des automatisations, définissez-les au minimum sur Enabled with confirmation.
4. L'utilisateur enregistre et utilise le connecteur
Après l'enregistrement, le connecteur est disponible pour les agents et les étapes de workflow, où des fonctions spécifiques de Google Trends peuvent être appelées selon les autorisations définies.
Paramètres de configuration du connecteur
| Paramètre | Obligatoire | Description |
|---|---|---|
Name | Oui | Nom interne du connecteur dans Siesta AI |
ApiKey | Selon la mise en œuvre | Clé API pour accéder au service |
Timezone | Oui | Fuseau horaire pour les requêtes (par exemple, UTC) |
Language | Oui | Langue des résultats (par exemple, EN, en-US) |
Fonctions prises en charge
1. GetInterestOverTimeAsync
Renvoie l'évolution de l'intérêt pour un ou plusieurs mots-clés dans le temps.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keywords | string | Oui | Liste de 1 à 5 mots-clés séparés par des virgules |
timeRange | string | Non | Période de temps pour l'analyse |
geo | string | Non | Zone géographique (code ISO du pays) |
category | int | Non | Catégorie Google Trends |
Valeurs par défaut :
timeRange:LastThreeMonthsgeo: globalement (valeur vide)category:0(toutes les catégories)
2. GetInterestByRegionAsync
Renvoie la répartition de l'intérêt pour un mot-clé donné par région.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keyword | string | Oui | Un mot-clé |
timeRange | string | Non | Période de temps |
resolution | string | Non | Niveau de résolution géographique |
geo | string | Non | Code du pays |
Valeurs par défaut :
resolution:COUNTRYgeo:US
3. CompareKeywordsAsync
Compare la popularité de plusieurs mots-clés dans le temps.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keywords | string | Oui | Liste de 2 à 5 mots-clés séparés par des virgules |
timeRange | string | Non | Période de temps |
geo | string | Non | Code du pays |
4. GetTrendingSearchesAsync
Renvoie les recherches actuellement tendance.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
country | string | Non | Nom du pays |
Valeur par défaut :
country:united_states
Comportement :
- Tentative principale via l'API Google Trends.
- En cas d'échec, fallback sur le flux RSS.
5. GetTodaySearchesAsync
Renvoie les recherches tendance aujourd'hui.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
country | string | Non | Code du pays |
Valeur par défaut :
country:US
Comportement :
- Principalement API, en cas d'échec, fallback sur le flux RSS.
6. GetAllTrendingSearchesAsync
Renvoie les recherches tendance à l'échelle mondiale à travers plusieurs pays.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| - | - | - | La fonction ne nécessite pas de paramètres |
Comportement :
- tentative d'obtention de données via l'API,
- fallback sur le flux RSS multi-pays.
7. GetRelatedQueriesAsync
Renvoie les requêtes associées à un mot-clé donné.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keyword | string | Oui | Mot-clé |
timeRange | string | Non | Période de temps |
geo | string | Non | Code du pays |
La sortie contient :
Top queries(requêtes associées les plus fréquentes),Rising queries(requêtes en forte croissance).
8. GetRelatedTopicsAsync
Renvoie les sujets associés à un mot-clé donné.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keyword | string | Oui | Mot-clé |
timeRange | string | Non | Période de temps |
geo | string | Non | Code du pays |
La sortie contient :
Top topics,Rising topics.
9. GetSuggestionsAsync
Renvoie des suggestions de recherche (autocomplete) pour un mot-clé donné.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
keyword | string | Oui | Mot-clé partiel ou complet |
10. GetCategoriesAsync
Renvoie la liste complète des catégories de Google Trends.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| - | - | - | La fonction ne nécessite pas de paramètres |
Valeurs prises en charge pour timeRange
timeRange est insensible à la casse et prend en charge les valeurs suivantes :
| Valeur | Description |
|---|---|
LastHour | dernière heure |
LastFourHours | dernières 4 heures |
LastDay | dernières 24 heures |
LastWeek | derniers 7 jours |
LastMonth | derniers 30 jours |
LastThreeMonths | derniers 90 jours |
LastYear | dernières 12 mois |
LastFiveYears | dernières 5 ans |
FromStart | toutes les données historiques disponibles |
Si la valeur est invalide ou manquante, la valeur par défaut LastThreeMonths sera utilisée.
Contexte d'invocation
Le comportement du connecteur peut être influencé par le contexte d'exécution :
| Champ | Valeur par défaut | Description |
|---|---|---|
Language | en-US | Langue des résultats |
Timezone | 300 | Décalage du fuseau horaire en minutes |
Exemple :
Language: en-US
Timezone: 300
Stratégie de sources de données
Pour les points de terminaison traitant des recherches tendance, l'obtention des données se fait en deux étapes :
- Tentative d'obtention des données via l'API Google Trends.
- Si l'API ne répond pas ou renvoie des données incomplètes, le système utilise automatiquement le flux RSS de Google Trends.
Ce mécanisme garantit une meilleure disponibilité des données.
Limites
| Limitation | Valeur |
|---|---|
| Nombre de mots-clés dans la requête | 1-5 |
| Comparaison de mots-clés | 2-5 |
| Période de temps par défaut | LastThreeMonths |
Résumé
Le connecteur Google Trends est adapté aux cas d'utilisation analytiques, au suivi des sujets, aux workflows marketing et à la comparaison des tendances dans le temps. Il fournit une interface unifiée pour travailler avec les données de Google Trends, y compris une stratégie de fallback pour les recherches tendance.