Google Trends
Resumen
El conector de Google Trends proporciona acceso programático a los datos del servicio Google Trends. Permite a los agentes y aplicaciones obtener información sobre la popularidad de palabras clave, la distribución geográfica del interés, las búsquedas en tendencia actuales, las consultas relacionadas y las sugerencias de búsqueda.
El conector soporta principalmente:
- análisis histórico del interés en palabras clave,
- comparación de múltiples palabras clave,
- obtención de búsquedas en tendencia actuales,
- análisis de temas y consultas relacionadas,
- sugerencias de búsqueda (autocompletar).
Todas las funciones devuelven datos estructurados obtenidos de la API de Google Trends. En los endpoints para búsquedas en tendencia, se implementa un fallback a una fuente RSS si la API primaria devuelve un error o datos incompletos.
Historia de usuario: Cómo un usuario añade el conector de Google Trends
1. El usuario abre el diálogo Agregar Conexión y selecciona GoogleTrends
- En la administración, accede a la sección Connections / Connected Apps.
- Haz clic en Add Connection.
- En la lista de conectores, selecciona el mosaico GoogleTrends.
2. El usuario completa los detalles del conector
En el formulario Detail, completa:
- Name: nombre interno de la conexión (por ejemplo,
GoogleTrends). - Provide your ApiKey: clave API, no se requiere en esta implementación.
- Provide your Timezone: zona horaria (por ejemplo,
UTC). - Provide your Language: idioma de las respuestas (por ejemplo,
EN, CS).
3. El usuario establece los permisos de las funciones individuales
Después de crear la conexión, establece el modo de llamada para cada operación:
- Enabled,
- Enabled with confirmation,
- Disabled.
Recomendación: para las operaciones que pueden afectar la ejecución de automatizaciones, configúralas al menos en Enabled with confirmation.
4. El usuario guarda y utiliza el conector
Después de guardar, el conector está disponible para agentes y pasos de flujo de trabajo, donde se pueden invocar funciones específicas de Google Trends según los permisos establecidos.
Parámetros de configuración del conector
| Parámetro | Obligatorio | Descripción |
|---|---|---|
Name | Sí | Nombre interno del conector en Siesta AI |
ApiKey | Según implementación | Clave API para acceder al servicio |
Timezone | Sí | Zona horaria para las consultas (por ejemplo, UTC) |
Language | Sí | Idioma de los resultados (por ejemplo, EN, en-US) |
Funciones soportadas
1. GetInterestOverTimeAsync
Devuelve la evolución del interés en una o más palabras clave a lo largo del tiempo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keywords | string | Sí | Lista de 1-5 palabras clave separadas por comas |
timeRange | string | No | Período de tiempo para el análisis |
geo | string | No | Área geográfica (código ISO del país) |
category | int | No | Categoría de Google Trends |
Valores predeterminados:
timeRange:LastThreeMonthsgeo: globalmente (valor vacío)category:0(todas las categorías)
2. GetInterestByRegionAsync
Devuelve la distribución del interés en una palabra clave dada por regiones.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | Sí | Una palabra clave |
timeRange | string | No | Período de tiempo |
resolution | string | No | Nivel de resolución geográfica |
geo | string | No | Código del país |
Valores predeterminados:
resolution:COUNTRYgeo:US
3. CompareKeywordsAsync
Compara la popularidad de múltiples palabras clave a lo largo del tiempo.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keywords | string | Sí | Lista de 2-5 palabras clave separadas por comas |
timeRange | string | No | Período de tiempo |
geo | string | No | Código del país |
4. GetTrendingSearchesAsync
Devuelve las búsquedas en tendencia actuales.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
country | string | No | Nombre del país |
Valor predeterminado:
country:united_states
Comportamiento:
- Primer intento a través de la API de Google Trends.
- En caso de fallo, fallback a un feed RSS.
5. GetTodaySearchesAsync
Devuelve las búsquedas que están en tendencia hoy.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
country | string | No | Código del país |
Valor predeterminado:
country:US
Comportamiento:
- Principalmente API, en caso de fallo fallback a un feed RSS.
6. GetAllTrendingSearchesAsync
Devuelve las búsquedas en tendencia a nivel global en varios países.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| - | - | - | La función no requiere parámetros |
Comportamiento:
- intento de obtener datos a través de la API,
- fallback a un feed RSS multi-país.
7. GetRelatedQueriesAsync
Devuelve las consultas relacionadas con una palabra clave dada.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | Sí | Palabra clave |
timeRange | string | No | Período de tiempo |
geo | string | No | Código del país |
La salida incluye:
Top queries(consultas relacionadas más frecuentes),Rising queries(consultas de rápido crecimiento).
8. GetRelatedTopicsAsync
Devuelve los temas relacionados con una palabra clave dada.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | Sí | Palabra clave |
timeRange | string | No | Período de tiempo |
geo | string | No | Código del país |
La salida incluye:
Top topics,Rising topics.
9. GetSuggestionsAsync
Devuelve sugerencias de búsqueda (autocompletar) para una palabra clave dada.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
keyword | string | Sí | Palabra clave parcial o completa |
10. GetCategoriesAsync
Devuelve la lista completa de categorías de Google Trends.
| Parámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| - | - | - | La función no requiere parámetros |
Valores soportados para timeRange
timeRange es insensible a mayúsculas y soporta los siguientes valores:
| Valor | Descripción |
|---|---|
LastHour | última hora |
LastFourHours | últimas 4 horas |
LastDay | últimas 24 horas |
LastWeek | últimos 7 días |
LastMonth | últimos 30 días |
LastThreeMonths | últimos 90 días |
LastYear | últimos 12 meses |
LastFiveYears | últimos 5 años |
FromStart | todos los datos históricos disponibles |
Si el valor es inválido o falta, se usará el valor predeterminado LastThreeMonths.
Contexto de Invocación
El comportamiento del conector puede verse afectado por el contexto de ejecución:
| Campo | Valor predeterminado | Descripción |
|---|---|---|
Language | en-US | Idioma de los resultados |
Timezone | 300 | Desplazamiento de la zona horaria en minutos |
Ejemplo:
Language: en-US
Timezone: 300
Estrategia de fuentes de datos
En los endpoints que trabajan con búsquedas en tendencia, la obtención de datos se realiza en dos pasos:
- Intento de obtener datos de la API de Google Trends.
- Si la API no responde o devuelve datos incompletos, el sistema utiliza automáticamente el feed RSS de Google Trends.
Este mecanismo asegura una mayor disponibilidad de datos.
Límites
| Restricción | Valor |
|---|---|
| Número de palabras clave en la consulta | 1-5 |
| Comparación de palabras clave | 2-5 |
| Período de tiempo predeterminado | LastThreeMonths |
Resumen
El conector de Google Trends es adecuado para casos de uso analíticos, monitoreo de temas, flujos de trabajo de marketing y comparación de tendencias a lo largo del tiempo. Proporciona una interfaz unificada para trabajar con datos de Google Trends, incluyendo una estrategia de fallback para búsquedas en tendencia.