Herramientas de Google Ads
Campañas de búsqueda y Performance Max, palabras clave, textos de anuncio, conversiones, estrategias de puja y recomendaciones.
Los nombres y descripciones se generan directamente desde el código del servidor; las descripciones son la traducción del texto que ve el asistente, los nombres de herramientas y parámetros no cambian.
Herramientas de lectura45 herramientas
list_google_ads_accounts
Lectura1 créditosCuentas de Google Ads a las que puede acceder el usuario de Google conectado, incluidas las cuentas de cliente bajo cuentas MCC/administrador (id, nombre, moneda, zona horaria, administrador, login_customer_id) y cuál está seleccionada. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
Esta herramienta no recibe parámetros.
google_ads_report
Lectura2 créditosRendimiento de Google Ads (gasto, clics, impresiones, conversiones, ingresos, CTR, CPC, CPA, ROAS) por campaña, grupo de anuncios, palabra clave, dispositivo, ubicación, hora, día de la semana o cuenta (todas las cuentas de cliente MCC clasificadas). Rango de fechas por días o inicio/fin; compare_previous añade el periodo anterior. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
breakdownOpcional | campaign | ad_group | ad | keyword | search_term | device | location | hour | day_of_week | account | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
compare_previousOpcional | boolean | devuelve también el periodo anterior de la misma duración y la variación en % |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_device_report
Lectura2 créditosRendimiento de Google Ads dividido por dispositivo (móvil, escritorio, tableta, TV conectada) con CPA y ROAS por dispositivo. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
compare_previousOpcional | boolean | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_change_history
Lectura1 créditosQuién cambió qué y cuándo en la cuenta de Google Ads (últimos 30 días como máximo): usuario, herramienta (UI/API), recurso, operación y valores anterior → nuevo. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–30) | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
limitOpcional | integer (1–1000) | — |
resource_typeOpcional | AD | AD_GROUP | AD_GROUP_CRITERION | CAMPAIGN | CAMPAIGN_BUDGET | AD_GROUP_BID_MODIFIER | CAMPAIGN_CRITERION | AD_GROUP_AD | ASSET | CUSTOMER_ASSET | CAMPAIGN_ASSET | AD_GROUP_ASSET | ASSET_SET | ASSET_SET_ASSET | CAMPAIGN_ASSET_SET | — |
operationOpcional | CREATE | UPDATE | REMOVE | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads_recommendations
Lectura1 créditosRecomendaciones de optimización de Google (tipo, campaña, impacto estimado). Aplica las elegidas con apply_google_ads_recommendation. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
typesOpcional | array<string> | tipos de recomendación, p. ej. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
include_dismissedOpcional | boolean | — |
limitOpcional | integer (1–10000) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_ads_quality_score_report
Lectura2 créditosNivel de calidad de las palabras clave (1-10) con sus componentes (CTR esperado, relevancia del anuncio, experiencia de la página de destino) y gasto; resume las palabras clave con nivel bajo y qué componente las penaliza. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_keyword_planner
Lectura2 créditosIdeas del Planificador de palabras clave de Google Ads: búsquedas mensuales medias reales, competencia y rango de puja para la parte superior de la página a partir de palabras clave semilla o una URL. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
seed_keywordsOpcional | array<string> | — |
urlOpcional | string | — |
locationOpcional | string | nombres de ciudad/región, separados por comas |
countryOpcional | string | código ISO, por defecto TR |
languageOpcional | string | tr, en, de, fr, es, ar, ru |
limitOpcional | integer (10–500) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ip_exclusions
Lectura1 créditosExclusiones de IP en campañas de Google Ads. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ad_groups
Lectura1 créditosGrupos de anuncios (id, nombre, estado, CPC predeterminado) de la cuenta de Google Ads o de una campaña. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_shared_negative_lists
Lectura1 créditosListas compartidas de palabras clave negativas de la cuenta de Google Ads con recuento de palabras clave y campañas vinculadas. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
list_idOpcional | string | devolver también las palabras clave de esta lista |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_ads
Lectura1 créditosAnuncios de búsqueda adaptables con todos los títulos/descripciones, la etiqueta de rendimiento de Google (LOW/GOOD/BEST), la eficacia del anuncio y la URL final. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_conversion_actions
Lectura1 créditosAcciones de conversión de la cuenta de Google Ads: tipo, categoría, estado, principal/secundaria, recuento, ajustes de valor, ventana de conversión tras clic. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | also return conversions recorded per action in this window |
statusOpcional | string | only this status, e.g. ENABLED or REMOVED |
searchOpcional | string | name contains |
include_removedOpcional | boolean | also list removed actions (to verify a removal) |
limitOpcional | integer (1–200) | default 50 |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_asset_groups
Lectura1 créditosGrupos de recursos de Performance Max con eficacia del anuncio, URL finales y sus recursos de texto/imagen por tipo de campo. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
asset_group_idOpcional | string | — |
signalsOpcional | boolean | also return audience signals and search themes |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_demand_gen_campaigns
Lectura1 créditosCampañas Demand Gen de la cuenta de Google Ads con estado, puja, presupuesto diario y rendimiento del periodo (gasto, clics, impresiones, conversiones, ingresos, CTR, CPC, CPA, ROAS). Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_app_campaigns
Lectura1 créditosCampañas de aplicaciones de la cuenta de Google Ads con id de la app, tienda, objetivo de puja, estado, presupuesto diario y rendimiento del periodo. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_invalid_clicks_report
Lectura2 créditosInforme de clics no válidos (fraude de clics) por campaña y día a partir de las métricas de Google (metrics.invalid_clicks, metrics.invalid_click_rate, clicks, cost) de los últimos N días (por defecto 14); marca las campañas cuya tasa de clics no válidos supera el umbral (por defecto 10 %) o cuyo último día se disparó (3x la media anterior), más las ciudades con muchos clics y cero conversiones en campañas sospechosas. Límites honestos: Google solo informa de los clics no válidos que ya filtró y nunca expone las IP de quien hace clic; es una señal de alerta, no una prueba a nivel de IP. Los clics no válidos no se cobran. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
threshold_rateOpcional | number | tasa de clics no válidos sospechosa como fracción, por defecto 0.10 |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_merchant_accounts
Lectura1 créditosCuentas de Google Merchant Center accesibles con el token de Google conectado (Merchant API accounts v1beta): id, nombre, idioma, zona horaria, indicador de prueba. Usa el consentimiento de Google conectado; devuelve error=scope_missing cuando falta el ámbito de Merchant Center (auth/content): el usuario debe volver a autorizar Google.
Esta herramienta no recibe parámetros.
list_merchant_products
Lectura1 créditosProductos de Merchant Center (Merchant API products v1beta) con título, id de oferta, precio, disponibilidad, estado de aprobación por destino y problemas a nivel de artículo; filtra por rechazados / pendientes / productos con problemas. Usa el consentimiento de Google conectado; devuelve error=scope_missing cuando falta el ámbito de Merchant Center (auth/content): el usuario debe volver a autorizar Google.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada |
statusOpcional | all | disapproved | pending | approved | issues | issues = cualquier problema a nivel de artículo o país rechazado |
queryOpcional | string | fragmento del título o del id de oferta |
limitOpcional | integer (1–1000) | — |
get_merchant_product_issues
Lectura1 créditosProblemas a nivel de artículo de un producto de Merchant Center (código, gravedad, solución, descripción, países afectados) más sus estados por destino; marca qué problemas puede corregir el comerciante mediante los datos del producto. Usa el consentimiento de Google conectado; devuelve error=scope_missing cuando falta el ámbito de Merchant Center (auth/content): el usuario debe volver a autorizar Google.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada |
product_idOpcional | string | p. ej. online~tr~TR~SKU123 (de list_merchant_products) |
offer_idOpcional | string | — |
merchant_feed_status
Lectura1 créditosFuentes de datos de Merchant Center (feeds): tipo, método de entrada (API/FILE/UI/AUTOFEED), etiqueta de feed, idioma y, para feeds de archivo, el estado de procesamiento de la última carga, recuento de artículos y problemas. Usa el consentimiento de Google conectado; devuelve error=scope_missing cuando falta el ámbito de Merchant Center (auth/content): el usuario debe volver a autorizar Google.
| Parámetro | Tipo | Descripción |
|---|---|---|
account_idOpcional | string | id de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada |
google_ads_query
Lectura2 créditosEjecuta una única consulta SELECT de solo lectura en Google Ads Query Language y devuelve las filas sin procesar, para datos que ninguna herramienta específica ofrece. Solo se acepta un SELECT (sin ';', comentarios ni palabras clave de escritura); se impone LIMIT (≤1000). Los importes llegan en micros. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryObligatorio | string | una sentencia GAQL SELECT, p. ej. SELECT campaign.name, metrics.clicks FROM campaign WHERE segments.date DURING LAST_7_DAYS |
limitOpcional | integer (1–1000) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_details
Lectura1 créditosContenido completo de los anuncios de Google Ads (tipo, cada título/descripción de RSA con sus fijaciones, URL, plantilla de seguimiento, estado), además de la calidad del anuncio, las acciones de mejora de Google y la aprobación de políticas. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
ad_idOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_campaign_targeting
Lectura1 créditosSegmentación actual de una campaña (o grupo de anuncios) de Google Ads: ubicaciones con nombre, ubicaciones excluidas, segmentación por radio (lat/lng, radio, unidades), idiomas, ajustes de puja por dispositivo, audiencias y el ajuste de ubicación por presencia/interés. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_assets
Lectura2 créditosToda la biblioteca de recursos de Google Ads de la cuenta (texto, imágenes con tamaño, vídeos de YouTube, enlaces de sitio, textos destacados, fragmentos, llamadas, promociones, precios, formularios de clientes potenciales, WhatsApp), opcionalmente con dónde se usa cada uno y su aprobación. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
asset_typeOpcional | TEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED | — |
limitOpcional | integer (1–1000) | — |
include_usageOpcional | boolean | lista también qué campañas/grupos de anuncios usan cada recurso |
include_approvalOpcional | boolean | añade el estado de aprobación/revisión de políticas |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
rsa_asset_performance
Lectura2 créditosResultados por título y por descripción de los anuncios de búsqueda adaptables (impresiones, clics, coste, conversiones, valor, CPA, CTR, tasa de conversión) con la etiqueta LOW/GOOD/BEST de Google, la fijación y la calidad del anuncio. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
daysOpcional | integer (1–365) | — |
limitOpcional | integer (1–1000) | — |
min_impressionsOpcional | integer (0–…) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_historical_metrics
Lectura2 créditosMétricas históricas del Planificador de palabras clave para palabras que ya conoces: búsquedas medias y mes a mes, competencia, rango de puja para la parte superior de la página y CPC medio. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
keywordsObligatorio | array<string> | — |
language_idOpcional | string | id de constante de idioma de Google, por defecto 1037 (turco) |
languageOpcional | string | alternativa con código de idioma (tr, en…) |
geo_idsOpcional | array<string> | id de constantes de segmentación geográfica (geo_target_search), por defecto 2792 (Turquía) |
start_monthOpcional | string | YYYY-MM |
end_monthOpcional | string | YYYY-MM |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
keyword_quality_report
Lectura2 créditosNivel de calidad histórico día a día por palabra clave con sus tres componentes, señalando las fechas en que bajó y qué componente cambió. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
daysOpcional | integer (1–90) | — |
limitOpcional | integer (1–500) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_negative_keywords
Lectura1 créditosTodas las palabras clave negativas que se aplican: a nivel de campaña, a nivel de grupo de anuncios y las listas negativas compartidas vinculadas a campañas (con sus palabras clave). Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
smart_negative_keywords
Lectura2 créditosSugerencias de palabras clave negativas: términos de búsqueda que gastaron dinero sin ninguna conversión y que aún no son negativos en ningún lugar, ordenados por gasto (ahorro estimado). Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
min_wasteOpcional | number | gasto mínimo por término |
limitOpcional | integer (1–500) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
conversion_tracking_health
Lectura2 créditosRevisión del seguimiento de conversiones: acciones ocultas/eliminadas, acciones principales que no registraron nada en el periodo y una acción principal que falta. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
extension_asset_performance
Lectura2 créditosRendimiento de las extensiones de campaña (enlaces de sitio, textos destacados, llamada, fragmentos, promociones, precios, WhatsApp, imágenes, nombre/logotipo de la empresa): impresiones, clics, coste y conversiones por recurso. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
field_typeOpcional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | — |
limitOpcional | integer (1–1000) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_ad_schedule
Lectura1 créditosProgramación de anuncios actual de una campaña: día, hora de inicio/fin, ajuste de puja e id de criterio por franja. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
get_conversion_tags
Lectura1 créditosDetalles de etiqueta de las acciones de conversión: ID de conversión (AW-…), etiqueta y el valor send_to para Tag Manager / gtag, además de los fragmentos sin procesar. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
conversion_action_idsOpcional | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_extension_assets
Lectura1 créditosRecursos de extensión vinculados a una campaña o grupo de anuncios (enlaces de sitio, textos destacados, llamada, fragmentos, promociones, precios, WhatsApp, formulario de clientes potenciales, app, nombre/logotipo de la empresa) con el nombre de recurso del vínculo usado para quitarlos. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_conversion_goals
Lectura1 créditosObjetivos de conversión de la cuenta (categoría × origen) y si cada uno es principal/apto para pujas; con campaign_id también las anulaciones de objetivos de esa campaña. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_custom_conversion_goals
Lectura1 créditosObjetivos de conversión personalizados: nombre, las acciones de conversión que contienen, estado y las campañas que optimizan para cada uno. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
budget_pacing_alerts
Lectura2 créditosGasto del mes hasta la fecha frente al presupuesto diario de las campañas activas, proyectado a fin de mes; señala las campañas que van a superar o no alcanzar su presupuesto. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
threshold_pctOpcional | number (1–100) | desviación que activa una alerta, por defecto 10 |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
impression_share_analysis
Lectura2 créditosCuota de impresiones de búsqueda, cuota en la parte superior / superior absoluta, cuota de concordancia exacta y cuánto se perdió por presupuesto frente a ranking, además de los anuncios rechazados por campaña. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
levelOpcional | campaign | ad_group | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_audiences
Lectura1 créditosListas de audiencias (remarketing, sitio web basado en reglas, Customer Match, similares): id, tipo, estado, días de pertenencia, tamaño en Búsqueda/Display e idoneidad. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
limitOpcional | integer (1–1000) | — |
definitionOpcional | boolean | incluye la definición de regla / semilla de la lista |
searchOpcional | string | name contains, or exact list id |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_experiments
Lectura1 créditosLista los experimentos de campaña (pruebas A/B) con id, estado y fechas. Solo lectura; para finalizar o aplicar uno, usa manage_experiment. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | list | solo list; para finalizar o aplicar, manage_experiment |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
geo_target_search
Lectura1 créditosBusca por nombre los id de segmentación geográfica de Google: id, tipo (ciudad, provincia, país…), nombre canónico y alcance; usa los id en la segmentación por ubicación. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
queryObligatorio | string | — |
countryOpcional | string | pista de país ISO |
levelOpcional | string | filtra por tipo, p. ej. City, Province, Country, District, Postal Code |
limitOpcional | integer (1–50) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
google_campaign_diagnosis
Lectura2 créditosDiagnóstico de estado EN VIVO de una campaña de Google Ads. Llámala primero cuando el usuario informe de una advertencia o un estado (mal configurada, limitada, no apta, en aprendizaje, rechazada) y después para verificar un cambio. Devuelve el estado principal con cada motivo (código, significado, solución habitual, herramientas), el estado de publicación, la estrategia de puja con su CPA / ROAS objetivo, el campo que contiene el objetivo, el estado del sistema de la estrategia de puja (la causa real de una puja mal configurada), el tipo de objetivo de las campañas de aplicaciones, el presupuesto y el presupuesto recomendado por Google, las fechas de inicio y fin, las acciones de conversión optimizadas con su estado, hallazgos, recomendaciones y cambios recientes. Importes en la moneda de la cuenta. Solo lectura. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads; si se omite, se listan todas las campañas con un problema de estado |
relatedOpcional | boolean | por defecto true: también las recomendaciones de la campaña y los cambios de los últimos 14 días |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_ad_policy_issues
Lectura2 créditosAnuncios que Google rechazó o limitó, con los temas de política y el texto de evidencia de cada decisión. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
only_problemsOpcional | boolean | por defecto true: solo anuncios rechazados / limitados |
limitOpcional | integer (1–1000) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_lead_form_submissions
Lectura2 créditosClientes potenciales enviados mediante formularios de Google Ads (nombre, correo, teléfono y respuestas personalizadas, campaña, hora). Datos personales: trátalos con cuidado. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–90) | — |
asset_idOpcional | string | id del recurso de formulario de clientes potenciales |
limitOpcional | integer (1–1000) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
list_google_location_assets
Lectura1 créditosBusiness Profile location sync in Google Ads: location asset sets (LOCATION_SYNC, location groups), whether they are linked to the account, and the synced location assets. linked=false means ads cannot show the Business Profile address yet. Requires a connected Google Ads account; otherwise returns connected=false, never invented numbers.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramientas de escritura74 herramientas
select_google_ads_account
Escritura1 créditosCambia la cuenta de cliente de Google Ads que usarán todas las lecturas y escrituras siguientes (agencia/MCC: el login-customer-id correcto se establece automáticamente). Ajuste local; nada cambia en Google.
| Parámetro | Tipo | Descripción |
|---|---|---|
customer_idObligatorio | string | id de cliente de list_google_ads_accounts |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
apply_google_ads_recommendation
Escritura2 créditosAplica las recomendaciones de Google Ads seleccionadas (hasta 100). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
recommendationsObligatorio | array<string> | nombres de recurso de list_google_ads_recommendations |
actionOpcional | apply | dismiss | default apply |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_search_campaign
Escritura2 créditosCrea una campaña de búsqueda de Google en un solo flujo: presupuesto, campaña, segmentación por ubicación + idioma, estrategia de puja, grupo de anuncios, palabras clave y anuncio de búsqueda adaptable (el texto sale por defecto del perfil de marca). Se crea en PAUSED tras la aprobación. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | moneda de la cuenta |
locationsOpcional | array<string> | nombres de ciudad/región/país; por defecto: la ciudad del perfil de marca |
location_idsOpcional | array<string> | ids de constantes de segmentación geográfica de Google |
countryOpcional | string | — |
languagesOpcional | array<string> | códigos de idioma (tr, en…) o ids de idioma de Google; por defecto turco |
bid_strategyOpcional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | — |
target_cpaOpcional | number | — |
target_roasOpcional | number | — |
max_cpcOpcional | number | — |
cpc_bidOpcional | number | CPC predeterminado del grupo de anuncios |
keywordsOpcional | array<any> | — |
headlinesOpcional | array<any> | — |
descriptionsOpcional | array<any> | — |
final_urlOpcional | string | — |
ad_group_nameOpcional | string | — |
search_partnersOpcional | boolean | — |
end_dateOpcional | string | YYYY-MM-DD |
goalOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_pmax_campaign
Escritura2 créditosCrea una campaña Performance Max: presupuesto + campaña + grupo de recursos + recursos de texto + imágenes (descargadas de las URL indicadas y subidas) en una sola petición atómica, creada en PAUSED. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | — |
final_urlObligatorio | string | — |
business_nameObligatorio | string | ≤25 caracteres |
headlinesObligatorio | array<string> | 3-15, ≤30 caracteres |
long_headlinesObligatorio | array<string> | 1-5, ≤90 caracteres |
descriptionsObligatorio | array<string> | 2-5, ≤90 caracteres |
marketing_imagesObligatorio | array<string> | horizontal 1.91:1, al menos 1 |
square_marketing_imagesObligatorio | array<string> | 1:1, al menos 1 |
logo_imagesObligatorio | array<string> | logotipo 1:1, al menos 1 |
portrait_marketing_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
landscape_logo_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
bid_strategyOpcional | maximize_conversions | maximize_conversion_value | — |
target_cpaOpcional | number | — |
target_roasOpcional | number | — |
locationsOpcional | array<string> | — |
countryOpcional | string | — |
languagesOpcional | array<string> | — |
asset_group_nameOpcional | string | — |
end_dateOpcional | string | — |
goalOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_display_campaign
Escritura2 créditosCrea una campaña de Display: presupuesto + campaña + grupo de anuncios + anuncio de display adaptable (las imágenes se descargan de las URL indicadas, se recortan a la proporción de cada campo y se suben) en una sola petición atómica, en PAUSED. La red de búsqueda está desactivada; la campaña solo se publica en la Red de Display.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | — |
final_urlObligatorio | string | — |
business_nameObligatorio | string | ≤25 caracteres |
headlinesObligatorio | array<string> | 1-5, ≤30 caracteres |
long_headlineObligatorio | string | ≤90 caracteres |
descriptionsObligatorio | array<string> | 1-5, ≤90 caracteres |
marketing_imagesObligatorio | array<string> | horizontal 1.91:1, al menos 1 |
square_marketing_imagesOpcional | array<string> | 1:1, al menos 1 (si falta, se recorta de la imagen horizontal) |
logo_imagesOpcional | array<string> | image URLs (https) or Studio /medya files |
landscape_logo_imagesOpcional | array<string> | image URLs (https) or Studio /medya files |
bid_strategyOpcional | maximize_conversions | target_cpa | maximize_clicks | manual_cpc | — |
target_cpaOpcional | number | — |
max_cpcOpcional | number | — |
cpc_bidOpcional | number | — |
locationsOpcional | array<string> | — |
countryOpcional | string | — |
languagesOpcional | array<string> | — |
ad_group_nameOpcional | string | — |
end_dateOpcional | string | — |
goalOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_shopping_campaign
Escritura2 créditosCrea una campaña de Shopping estándar: presupuesto + campaña + grupo de anuncios + anuncio de producto en una sola petición atómica, en PAUSED. Los productos provienen de la cuenta de Merchant Center vinculada; la prioridad 0-2 decide qué campaña gana cuando varias tienen el mismo producto.
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | — |
merchant_idObligatorio | string | — |
campaign_priorityOpcional | 0 | 1 | 2 | — |
feed_labelOpcional | string | — |
enable_localOpcional | boolean | — |
bid_strategyOpcional | manual_cpc | maximize_clicks | target_roas | maximize_conversion_value | — |
target_roasOpcional | number | — |
max_cpcOpcional | number | — |
cpc_bidOpcional | number | — |
locationsOpcional | array<string> | — |
countryOpcional | string | — |
languagesOpcional | array<string> | — |
ad_group_nameOpcional | string | — |
end_dateOpcional | string | — |
goalOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_google_conversion_value_rules
Escritura2 créditosAjusta el valor de conversión en el momento de la subasta según una condición: p. ej. una conversión desde móvil cuenta 1,2 veces, o desde una ciudad concreta vale más. Una condición por regla (dispositivo, ubicación o audiencia); la regla se adjunta a un conjunto de reglas de valor de la cuenta o de una campaña.
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | create | remove | — |
operationOpcional | ADD | MULTIPLY | SET | — |
valueOpcional | number | para MULTIPLY 0,5-10; para ADD/SET mayor que 0 (en la moneda de la cuenta) |
device_typesOpcional | array<string> | e.g. MOBILE, DESKTOP, TABLET |
geo_target_idsOpcional | array<string> | — |
geo_match_typeOpcional | string | — |
user_list_idsOpcional | array<string> | — |
campaign_idOpcional | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
resource_nameOpcional | string | for action=remove |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_google_campaign
Escritura2 créditosRenombra, pausa/activa o establece/quita la fecha de fin de una campaña de Google Ads; la vista previa muestra actual → nuevo. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
nameOpcional | string | — |
statusOpcional | pause | enable | — |
end_dateOpcional | string | null | YYYY-MM-DD, o null para ejecutarse indefinidamente |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
rename_google_campaigns
Escritura2 créditosRenombra campañas de Google Ads en bloque (lista explícita, patrón de nombres o buscar/reemplazar). La vista previa es una tabla anterior → nuevo; los nombres deben seguir siendo únicos. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
renamesOpcional | array<object> | — |
campaign_idsOpcional | array<string> | — |
patternOpcional | string | patrón de nombres con {name}, {channel}, {id}, p. ej. 'Brand | {channel} | {name}' |
findOpcional | string | — |
replaceOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
remove_google_campaign
EscrituraIrreversible2 créditosElimina PERMANENTEMENTE una campaña de Google Ads (no se puede deshacer ni reactivar; el historial permanece en los informes). Nunca se aplica automáticamente: siempre espera la aprobación explícita del usuario. Si hay dudas, prefiere update_google_campaign(status=pause). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_google_bid_strategy
Escritura2 créditosCambia la puja de una campaña de Google Ads: maximizar conversiones (CPA objetivo opcional), maximizar valor de conversión (ROAS objetivo opcional), CPA objetivo, ROAS objetivo, CPC manual, maximizar clics. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación). En una campaña de aplicaciones no se puede cambiar el tipo de estrategia; solo se actualiza su objetivo (target_cpa = coste objetivo por instalación / acción en la aplicación, o target_roas). Lee la causa con google_campaign_diagnosis antes de cambiar un objetivo para eliminar una advertencia. El valor anterior se guarda y el cambio se puede deshacer.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
strategyObligatorio | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share | — |
target_cpaOpcional | number | moneda de la cuenta |
target_roasOpcional | number | proporción, 4.0 = 400 % |
max_cpcOpcional | number | techo de CPC para maximize_clicks |
impression_share_locationOpcional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOpcional | number (1–100) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_google_ad_schedule
Escritura2 créditosEstablece la programación de anuncios de una campaña de Google Ads (franjas de día/hora con ajuste de puja opcional); los anuncios no se muestran fuera de las franjas. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
replaceOpcional | boolean | eliminar primero la programación existente |
scheduleObligatorio | array<object> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_google_location_targets
Escritura2 créditosSegmenta o excluye ubicaciones en una campaña de Google Ads; los nombres se resuelven con las sugerencias de segmentación geográfica de Google y se muestran en la vista previa. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
locationsOpcional | array<string> | nombres, p. ej. İstanbul, Ankara |
location_idsOpcional | array<string> | — |
countryOpcional | string | código ISO orientativo, por defecto TR |
excludeOpcional | boolean | — |
replaceOpcional | boolean | eliminar primero las ubicaciones segmentadas existentes |
bid_adjustmentOpcional | number | porcentaje |
languagesOpcional | array<string> | language codes (tr, en…) or Google language ids to target |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
merge_google_campaigns
EscrituraIrreversible2 créditosFusión segura de campañas: pausa las campañas de origen y traslada su presupuesto diario a la de destino (Google no permite mover grupos de anuncios entre campañas). Sujeto a la barrera de presupuesto (máx. +50 % por cambio); nunca se aplica automáticamente. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
target_campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
source_campaign_idsObligatorio | array<string> | — |
move_budgetOpcional | boolean | sumar los presupuestos diarios de origen al destino (por defecto true) |
new_daily_budgetOpcional | number | presupuesto diario de destino explícito en lugar de la suma |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
exclude_google_ips
Escritura2 créditosExcluye direcciones IP (protección contra fraude de clics) de una campaña de Google Ads (bloqueo de IP negativo a nivel de campaña, máx. 500). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ipsObligatorio | array<string> | direcciones IPv4/IPv6 o bloques CIDR |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
unblock_ip_addresses
Escritura2 créditosQuita exclusiones de IP de una campaña de Google Ads (lo contrario de exclude_google_ips); solo se quitan las IP realmente excluidas en la campaña. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ipsObligatorio | array<string> | direcciones IPv4/IPv6 o bloques CIDR que se dejan de excluir |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_ad_group
Escritura2 créditosAñade un grupo de anuncios de búsqueda a una campaña de Google Ads, opcionalmente con palabras clave y un anuncio de búsqueda adaptable. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
nameObligatorio | string | — |
cpc_bidOpcional | number | — |
keywordsOpcional | array<any> | — |
headlinesOpcional | array<any> | — |
descriptionsOpcional | array<any> | — |
final_urlOpcional | string | — |
path1Opcional | string | — |
path2Opcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_google_ad_group_status
Escritura2 créditosPausa o activa grupos de anuncios de Google Ads. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idsOpcional | array<string> | — |
ad_group_idOpcional | string | — |
statusObligatorio | pause | enable | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
pause_google_ad_groups
Escritura2 créditosPausa varios grupos de anuncios de Google Ads a la vez (p. ej. grupos sin conversiones de google_ads_report breakdown=ad_group). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idsObligatorio | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_google_keywords
Escritura2 créditosAñade palabras clave (texto, BROAD|PHRASE|EXACT, puja de CPC opcional) a un grupo de anuncios de Google Ads. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | — |
keywordsObligatorio | array<any> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_google_keyword
Escritura2 créditosPausa/activa una palabra clave de Google Ads, cambia su puja de CPC o su tipo de concordancia (Google exige eliminar + volver a añadir; se hace en una sola petición atómica). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | — |
keyword_idObligatorio | string | — |
statusOpcional | pause | enable | — |
bidOpcional | number | — |
match_typeOpcional | BROAD | PHRASE | EXACT | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
remove_google_negative_keywords
EscrituraIrreversible2 créditosElimina palabras clave negativas (por texto y, opcionalmente, tipo de concordancia) de una campaña de Google Ads o de una lista negativa compartida: el deshacer de una negativa errónea. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
shared_list_idOpcional | string | — |
keywordsOpcional | array<string> | — |
criterion_idsOpcional | array<string> | negative criterion ids (list_negative_keywords) instead of / in addition to text |
match_typeOpcional | BROAD | PHRASE | EXACT | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_to_google_shared_negative_list
Escritura2 créditosAñade negativas (cada una con su tipo de concordancia) a una lista negativa compartida de toda la cuenta —o crea una— y la vincula a campañas. Los términos existentes se omiten. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
list_idOpcional | string | — |
list_nameOpcional | string | crea una lista nueva cuando no se indica list_id |
keywordsObligatorio | array<any> | — |
attach_campaign_idsOpcional | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_rsa
Escritura2 créditosCrea un anuncio de búsqueda adaptable (3-15 títulos ≤30, 2-4 descripciones ≤90, fijación opcional) en un grupo de anuncios de Google Ads. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | — |
headlinesObligatorio | array<any> | — |
descriptionsObligatorio | array<any> | — |
final_urlObligatorio | string | — |
path1Opcional | string | — |
path2Opcional | string | — |
final_mobile_urlOpcional | string | — |
tracking_url_templateOpcional | string | — |
statusOpcional | enable | pause | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_google_rsa_assets
Escritura2 créditosRenueva títulos/descripciones débiles de un RSA: Google no permite editar el texto de un RSA, así que se crea un anuncio nuevo con el conjunto nuevo y se pausa el antiguo en una sola petición. La vista previa muestra el texto anterior → nuevo. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | — |
ad_idObligatorio | string | — |
replace_low_performingOpcional | boolean | — |
remove_headlinesOpcional | array<string> | — |
add_headlinesOpcional | array<any> | — |
remove_descriptionsOpcional | array<string> | — |
add_descriptionsOpcional | array<any> | — |
headlinesOpcional | array<any> | — |
descriptionsOpcional | array<any> | — |
final_urlOpcional | string | — |
path1Opcional | string | — |
path2Opcional | string | — |
pause_oldOpcional | boolean | por defecto true |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_google_sitelinks
Escritura2 créditosAñade recursos de enlaces de sitio (texto ≤25, dos descripciones opcionales ≤35, URL final) a una campaña de Google Ads. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
sitelinksObligatorio | array<object> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_google_callouts
Escritura2 créditosAñade recursos de texto destacado (≤25 caracteres) a una campaña de Google Ads. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
calloutsObligatorio | array<string> | ≤25 caracteres cada uno |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_conversion_action
Escritura2 créditosCrea una acción de conversión de sitio web; el resultado incluye el fragmento de etiqueta a instalar (p. ej. con las herramientas de Tag Manager). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
categoryOpcional | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeOpcional | one | many | — |
primary_for_goalOpcional | boolean | — |
default_valueOpcional | number | — |
currencyOpcional | string | — |
always_use_default_valueOpcional | boolean | — |
click_through_window_daysOpcional | integer (1–90) | — |
view_through_window_daysOpcional | integer (1–30) | — |
phone_call_duration_secondsOpcional | integer (0–10800) | — |
typeOpcional | WEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALL | default WEBPAGE; UPLOAD_CLICKS for offline conversion upload |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_google_conversion_action
Escritura2 créditosCambia una acción de conversión de Google Ads: principal o secundaria (primary_for_goal), estado, categoría, recuento, ajustes de valor, ventana de conversión tras clic. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
conversion_action_idObligatorio | string | — |
nameOpcional | string | — |
statusOpcional | enable | hide | remove | ENABLED | HIDDEN | REMOVED | — |
categoryOpcional | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
counting_typeOpcional | one | many | — |
primary_for_goalOpcional | boolean | — |
default_valueOpcional | number | — |
currencyOpcional | string | — |
always_use_default_valueOpcional | boolean | — |
click_through_window_daysOpcional | integer (1–90) | — |
view_through_window_daysOpcional | integer (1–30) | — |
phone_call_duration_secondsOpcional | integer (0–10800) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_google_asset_group_assets
Escritura2 créditosAñade títulos, títulos largos, descripciones e imágenes (descargadas de URL y subidas) a un grupo de recursos de Performance Max en una sola petición atómica. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
asset_group_idObligatorio | string | — |
headlinesOpcional | array<string> | — |
long_headlinesOpcional | array<string> | — |
descriptionsOpcional | array<string> | — |
business_nameOpcional | string | — |
marketing_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
square_marketing_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
logo_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
portrait_marketing_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
landscape_logo_imagesOpcional | array<string> | URL de imagen (https) o archivos de Studio /medya |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_google_image_asset
Escritura2 créditosSube imágenes a la biblioteca de recursos de Google Ads (assets:mutate, imageAsset); el resultado devuelve nombres de recurso reutilizables en create_google_demand_gen_campaign / create_google_app_campaign. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
imagesObligatorio | array<any> | URL https o archivos de Studio /medya (JPEG/PNG/GIF, ≤5120 KB), hasta 20 |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_demand_gen_campaign
Escritura2 créditosCrea una campaña de Google Demand Gen (YouTube, Discover, Gmail): presupuesto + campaña (advertising_channel_type DEMAND_GEN) + grupo de anuncios + anuncio multirrecurso (DemandGenMultiAssetAdInfo: títulos, descripciones, nombre de empresa, logotipo, imágenes horizontales/cuadradas/verticales subidas desde URL o vinculadas por id de recurso), segmentación opcional por audiencia, ubicación e idioma, pujas de maximizar conversiones / tCPA / tROAS. Se crea en PAUSED tras la aprobación. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | moneda de la cuenta |
final_urlObligatorio | string | — |
business_nameObligatorio | string | ≤25 caracteres |
headlinesObligatorio | array<string> | 1-5, ≤40 caracteres |
descriptionsObligatorio | array<string> | 1-5, ≤90 caracteres |
marketing_imagesOpcional | array<string> | horizontal 1.91:1: URL a subir o ids de recurso existentes |
square_marketing_imagesOpcional | array<string> | 1:1: URL o ids de recurso |
portrait_marketing_imagesOpcional | array<string> | 4:5: URL o ids de recurso |
logo_imagesObligatorio | array<string> | logotipo 1:1, al menos 1: URL o ids de recurso |
call_to_actionOpcional | string | p. ej. Learn more, Shop now (≤15 caracteres) |
bid_strategyOpcional | maximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks | — |
target_cpaOpcional | number | — |
target_roasOpcional | number | — |
max_cpcOpcional | number | — |
audience_idsOpcional | array<string> | ids de audiencia de Google Ads (Gestor de audiencias) para segmentar el grupo de anuncios; vacío = amplia |
locationsOpcional | array<string> | — |
location_idsOpcional | array<string> | — |
countryOpcional | string | — |
languagesOpcional | array<string> | — |
ad_group_nameOpcional | string | — |
end_dateOpcional | string | YYYY-MM-DD |
goalOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_app_campaign
Escritura2 créditosCrea una campaña de aplicaciones de Google (advertising_channel_type MULTI_CHANNEL, subtipo APP_CAMPAIGN, app_campaign_setting con id de la app, tienda y objetivo de puja): presupuesto + campaña + grupo de anuncios + anuncio de app (recursos de texto, imágenes/vídeos opcionales), puja por CPI/CPA objetivo o ROAS, segmentación por ubicación/idioma. Se crea en PAUSED tras la aprobación; la app debe estar vinculada a la cuenta. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
daily_budgetObligatorio | number | moneda de la cuenta |
app_idObligatorio | string | id numérico de app de Apple (p. ej. 284815942) o nombre de paquete Android (p. ej. com.example.app) |
app_storeObligatorio | apple | google | — |
goalOpcional | installs | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registration | installs = coste objetivo por instalación (por defecto); in_app_actions = instalaciones con probabilidad de acción en la app (tCPI); in_app_actions_cpa = coste objetivo por acción en la app; value = ROAS objetivo; installs_no_target / pre_registration = maximizar |
target_cpaOpcional | number | coste objetivo por instalación / acción en la app |
target_roasOpcional | number | — |
conversion_action_idsOpcional | array<string> | acciones de conversión en la app para objetivos in_app / value (list_google_conversion_actions) |
headlinesObligatorio | array<string> | 2-5, ≤30 caracteres |
descriptionsObligatorio | array<string> | 1-5, ≤90 caracteres |
imagesOpcional | array<string> | URL de imágenes opcionales a subir o ids de recurso existentes |
video_asset_idsOpcional | array<string> | ids de recursos de vídeo de YouTube existentes |
locationsOpcional | array<string> | — |
location_idsOpcional | array<string> | — |
countryOpcional | string | — |
languagesOpcional | array<string> | — |
ad_group_nameOpcional | string | — |
end_dateOpcional | string | YYYY-MM-DD |
goal_noteOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_google_app_ad
Escritura2 créditosReemplaza los títulos y descripciones de un anuncio de campaña de app de Google (texto actual con get_ad_details). El resultado conserva el texto anterior.
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
headlinesOpcional | array<string> | 2-5, up to 30 characters |
descriptionsOpcional | array<string> | 1-5, up to 90 characters |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
google_click_fraud_guard
Escritura2 créditosProtección contra fraude de clics: encuentra campañas con tasas sospechosas de clics no válidos (o recibe campaign_ids) y excluye las direcciones IP indicadas en cada una (bloqueo de IP negativo a nivel de campaña). Sin ips solo informa de las campañas sospechosas y las anomalías geográficas: la API de Google Ads nunca revela las IP de quien hace clic, así que las exclusiones necesitan direcciones obtenidas por ti. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads solo tras la aprobación y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
daysOpcional | integer (1–365) | — |
start_dateOpcional | string | YYYY-MM-DD |
end_dateOpcional | string | YYYY-MM-DD |
threshold_rateOpcional | number | — |
campaign_idsOpcional | array<string> | campañas explícitas; por defecto: las campañas marcadas por el informe de clics no válidos |
ipsOpcional | array<string> | direcciones IPv4/IPv6 o bloques CIDR de tus propios registros de servidor/analítica |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upsert_merchant_product
Escritura2 créditosAñade o actualiza una entrada de producto de Merchant Center (products v1beta productInputs:insert; sustituye una entrada existente con el mismo id de oferta, idioma, etiqueta de feed y fuente de datos). Crea un elemento de aprobación con vista previa; se envía a Google solo tras la aprobación y solo con una cuenta de Google conectada. Usa el consentimiento de Google conectado; devuelve error=scope_missing cuando falta el ámbito de Merchant Center (auth/content): el usuario debe volver a autorizar Google.
| Parámetro | Tipo | Descripción |
|---|---|---|
offer_idObligatorio | string | — |
content_languageOpcional | string | por defecto tr |
feed_labelOpcional | string | por defecto TR |
account_idOpcional | string | id de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada |
data_sourceOpcional | string | id de la fuente de datos; por defecto: la fuente de datos de productos API/principal de la cuenta |
titleOpcional | string | — |
descriptionOpcional | string | — |
linkOpcional | string | — |
image_linkOpcional | string | — |
priceOpcional | number | — |
sale_priceOpcional | number | — |
currencyOpcional | string | ISO, por defecto TRY |
availabilityOpcional | in stock | out of stock | preorder | backorder | — |
conditionOpcional | new | refurbished | used | — |
brandOpcional | string | — |
gtinOpcional | string | — |
googleProductCategoryOpcional | string | — |
imageLinkOpcional | string | Alias of image_link |
channelOpcional | ONLINE | LOCAL | default ONLINE |
attributesOpcional | object | otros atributos de producto de la Merchant API (camelCase), p. ej. color, sizes, itemGroupId, customLabel0 |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_experiment
EscrituraIrreversible2 créditosFinaliza un experimento de campaña (prueba A/B) o aplica sus cambios de prueba a la campaña base. Irreversible; siempre espera aprobación explícita. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.
| Parámetro | Tipo | Descripción |
|---|---|---|
experiment_idObligatorio | string | — |
actionObligatorio | end | promote | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_demand_gen_ad
Escritura2 créditosAñade un anuncio de vídeo de YouTube (DemandGenVideoResponsiveAd) a un grupo de anuncios de Demand Gen: la creatividad que permite publicar una campaña de vídeo de Demand Gen. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
youtube_videoObligatorio | string | URL de YouTube o id de 11 caracteres, o un id de recurso de vídeo existente |
headlinesObligatorio | array<string> | 1-5, ≤40 |
long_headlinesObligatorio | array<string> | 1-5, ≤90 |
descriptionsObligatorio | array<string> | 1-5, ≤90 |
business_nameObligatorio | string | — |
final_urlObligatorio | string | — |
logo_asset_idObligatorio | string | id de recurso de logotipo 1:1 o URL de imagen |
call_to_actionOpcional | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | SHOP_NOW | BUY_NOW | ORDER_NOW | SEE_MORE | START_NOW | VISIT_SITE | WATCH_NOW | — |
ad_nameOpcional | string | — |
statusOpcional | enable | pause | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
copy_ad_group
Escritura2 créditosDuplica grupos de anuncios con sus palabras clave, negativas, anuncios de búsqueda responsivos, recursos del grupo y audiencias en otra campaña (o la misma) en una sola petición atómica; las copias empiezan en pausa por defecto. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idsObligatorio | array<string> | — |
target_campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
new_nameOpcional | string | — |
name_suffixOpcional | string | — |
statusOpcional | pause | enable | por defecto pause |
cpc_bidOpcional | number | — |
include_keywordsOpcional | boolean | — |
include_negativesOpcional | boolean | — |
include_adsOpcional | boolean | — |
include_assetsOpcional | boolean | — |
include_audiencesOpcional | boolean | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_ad_group_targeting
Escritura2 créditosSegmentación por ubicación e idioma en un grupo de anuncios (donde Demand Gen la guarda): añade o sustituye lugares e idiomas segmentados / excluidos. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
locationsOpcional | array<string> | — |
location_idsOpcional | array<string> | — |
negative_locationsOpcional | array<string> | — |
negative_location_idsOpcional | array<string> | — |
languagesOpcional | array<string> | — |
countryOpcional | string | — |
modeOpcional | add | replace | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_ad_group
Escritura2 créditosRenombra un grupo de anuncios de Google Ads, cambia su CPC máximo predeterminado y/o lo pausa/activa. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
nameOpcional | string | — |
cpc_bidOpcional | number | — |
statusOpcional | pause | enable | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_ad_status
EscrituraIrreversible2 créditosActiva, pausa o elimina definitivamente un anuncio de Google Ads. REMOVED no se puede deshacer y siempre espera una aprobación explícita. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
ad_idObligatorio | string | — |
statusObligatorio | ENABLED | PAUSED | REMOVED | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_pmax_assets
Escritura2 créditosAñade y quita recursos de texto de un grupo de recursos de Performance Max en una sola petición (imágenes: add_google_asset_group_assets). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
asset_group_idObligatorio | string | — |
headlinesOpcional | array<string> | — |
long_headlinesOpcional | array<string> | — |
descriptionsOpcional | array<string> | — |
remove_resource_namesOpcional | array<string> | vínculos de recursos del grupo de recursos de list_google_asset_groups |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_rsa
Escritura2 créditosEdita en el sitio un anuncio de búsqueda adaptable (mismo id de anuncio, historial conservado): sustituye el conjunto completo o añade/quita títulos/descripciones sueltos, cambia fijaciones, URL final y rutas. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_idObligatorio | string | — |
headlinesOpcional | array<any> | — |
descriptionsOpcional | array<any> | — |
add_headlinesOpcional | array<any> | — |
remove_headlinesOpcional | array<string> | — |
add_descriptionsOpcional | array<any> | — |
remove_descriptionsOpcional | array<string> | — |
headline_pinsOpcional | object | {texto: campo de fijación} — una cadena vacía quita la fijación |
description_pinsOpcional | object | {texto: campo de fijación} — una cadena vacía quita la fijación |
final_urlOpcional | string | — |
path1Opcional | string | — |
path2Opcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
add_negative_keyword
Escritura2 créditosAñade una o varias palabras clave negativas a nivel de campaña o de grupo de anuncios (cada una con su propio tipo de concordancia); las existentes se omiten. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
textOpcional | string | — |
keywordsOpcional | array<any> | — |
match_typeOpcional | BROAD | PHRASE | EXACT | — |
skip_existingOpcional | boolean | por defecto true |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_keywords
EscrituraIrreversible2 créditosPausa / activa / elimina definitivamente en bloque palabras clave existentes, o define su CPC máximo o las URL finales a nivel de palabra clave. remove espera una aprobación explícita. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
ad_group_idObligatorio | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
criterion_idsObligatorio | array<string> | — |
actionObligatorio | pause | enable | remove | set_bid | set_url | — |
cpc_bidOpcional | number | — |
final_urlOpcional | string | — |
final_mobile_urlOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_shared_negative_list
EscrituraIrreversible2 créditosGestiona las listas compartidas de palabras clave negativas a nivel de cuenta: crear, añadir/quitar palabras clave, vincular o desvincular campañas, renombrar, eliminar (eliminar espera una aprobación explícita). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
actionObligatorio | create | add_keywords | remove_keywords | attach | detach | rename | delete | — |
shared_set_idOpcional | string | — |
nameOpcional | string | — |
keywordsOpcional | array<any> | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
campaign_idsOpcional | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
dismiss_recommendations
Escritura2 créditosDescarta las recomendaciones de Google Ads que no quieres. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
resource_namesObligatorio | array<string> | de list_google_ads_recommendations |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_extension_assets
Escritura2 créditosAñade recursos de extensión a una campaña (o a un grupo de anuncios) en una sola petición atómica: enlaces de sitio, textos destacados, fragmento estructurado, llamada, mensaje de WhatsApp, promociones y una lista de precios. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
sitelinksOpcional | array<object> | — |
calloutsOpcional | array<string> | — |
snippet_headerOpcional | string | p. ej. Services, Brands, Types, Destinations |
snippet_valuesOpcional | array<string> | — |
phone_numberOpcional | string | — |
phone_countryOpcional | string | — |
whatsapp_numberOpcional | string | — |
whatsapp_countryOpcional | string | — |
whatsapp_greetingOpcional | string | — |
whatsapp_ctaOpcional | APPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE | — |
whatsapp_cta_textOpcional | string | — |
promotionsOpcional | array<object> | — |
pricesOpcional | object | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
remove_extension_assets
EscrituraIrreversible2 créditosDesvincula recursos de extensión de una campaña o grupo de anuncios (los recursos siguen en la biblioteca y se pueden volver a vincular). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
resource_namesOpcional | array<string> | nombres de recurso de vínculo de list_extension_assets |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
field_typeOpcional | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE | con campaign_id: quita todos los vínculos de este tipo |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_sitelink
Escritura2 créditosEdita en el sitio un enlace de sitio existente (texto del enlace, las dos líneas de descripción, URL final) sin volver a crearlo. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
asset_idObligatorio | string | — |
link_textOpcional | string | — |
description1Opcional | string | — |
description2Opcional | string | — |
final_urlOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_portfolio_bidding_strategy
Escritura2 créditosEstrategias de puja de cartera (compartidas): listarlas, crear una, cambiar sus objetivos o vincularle una campaña. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | list | create | update | assign | — |
nameOpcional | string | — |
strategyOpcional | target_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share | — |
target_cpaOpcional | number | — |
target_roasOpcional | number | — |
max_cpcOpcional | number | — |
min_cpcOpcional | number | — |
impression_share_locationOpcional | ANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE | — |
impression_share_percentOpcional | number (1–100) | — |
bidding_strategy_idOpcional | string | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_google_bidding_periods
Escritura2 créditosAvisa a las Smart Bidding de un periodo corto por adelantado: un ajuste estacional para una promoción o un lanzamiento (multiplicador esperado de la tasa de conversión) o una exclusión de datos para días con la medición rota (sitio caído, etiqueta ausente), de modo que esos días no entrenen al sistema de puja. Consulta las existentes con google_ads_query. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | create | remove | — |
typeObligatorio | seasonality | data_exclusion | — |
nameOpcional | string | — |
scopeOpcional | CAMPAIGN | CHANNEL | — |
campaign_idsOpcional | array<string> | — |
channel_typesOpcional | array<string> | — |
devicesOpcional | array<string> | — |
start_date_timeOpcional | string | AAAA-MM-DD o AAAA-MM-DD HH:MM:SS, en la zona horaria de la cuenta |
end_date_timeOpcional | string | AAAA-MM-DD o AAAA-MM-DD HH:MM:SS, en la zona horaria de la cuenta |
conversion_rate_modifierOpcional | number (0.1–10) | solo ajuste estacional: 1,2 = se esperan un 20 % más de conversiones |
resource_nameOpcional | string | for action=remove |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_recommendation_auto_apply
Escritura2 créditosMuestra y cambia por tipo la aplicación automática de recomendaciones de Google. Activarla siempre espera una aprobación explícita, porque después Google modifica la cuenta por su cuenta. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
actionOpcional | list | enable | disable | — |
typesOpcional | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_conversion_goal
Escritura2 créditosConvierte un objetivo de conversión (categoría × origen) en principal o secundario para la cuenta o una campaña — lo que optimiza Smart Bidding. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
categoryObligatorio | DEFAULT | PAGE_VIEW | PURCHASE | SIGNUP | DOWNLOAD | ADD_TO_CART | BEGIN_CHECKOUT | SUBSCRIBE_PAID | PHONE_CALL_LEAD | SUBMIT_LEAD_FORM | BOOK_APPOINTMENT | REQUEST_QUOTE | GET_DIRECTIONS | OUTBOUND_CLICK | CONTACT | ENGAGEMENT | QUALIFIED_LEAD | CONVERTED_LEAD | — |
originOpcional | WEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS | — |
roleObligatorio | primary | secondary | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_custom_conversion_goal
EscrituraIrreversible2 créditosCrea, edita (acciones incluidas, nombre) o elimina un objetivo de conversión personalizado; eliminar espera una aprobación explícita. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
goal_idOpcional | string | omítelo para crear un objetivo nuevo |
conversion_actionsOpcional | array<string> | — |
nameOpcional | string | — |
removeOpcional | boolean | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_offline_conversions
Escritura2 créditosSube conversiones offline (CRM) por id de clic (gclid/gbraid/wbraid) o correo/teléfono con hash (conversiones avanzadas para clientes potenciales); los correos/teléfonos se cifran con hash SHA-256 antes de guardar nada. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
conversion_actionObligatorio | string | id de una acción de conversión UPLOAD_CLICKS |
currency_codeOpcional | string | — |
conversionsObligatorio | array<object> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
upload_conversion_adjustments
Escritura2 créditosRetracta (reembolso/cancelación) o reformula el valor de conversiones ya informadas, por id de pedido o gclid + hora. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
conversion_actionObligatorio | string | — |
currency_codeOpcional | string | — |
adjustmentsObligatorio | array<object> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_customer_match_audience
Escritura2 créditosCrea una lista vacía de Segmentación por clientes (Customer Match, datos propios). Los miembros se añaden por las vías de carga propias de Google; esta herramienta nunca sube datos personales. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
membership_daysOpcional | integer (1–540) | — |
upload_key_typeOpcional | CONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
link_google_business_profile
Escritura2 créditosLink Google Business Profile locations to the Google Ads account as location assets (address, directions, call in ads; store visit conversions). Uses the connected Business Profile; filter by business name, label or listing id when the profile has several businesses. Only one sync per account; an existing one is reused. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
business_name_filterOpcional | string | only listings with this business name |
label_filtersOpcional | array<string> | only listings with one of these Business Profile labels |
listing_idsOpcional | array<string> | only these Business Profile listing ids |
business_account_idOpcional | string | — |
emailOpcional | string | Business Profile account e-mail; default: the connected Google account |
nameOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_google_campaign_locations
Escritura2 créditosShow only some Business Profile locations in one campaign's ads (dynamic location group by label or listing id), so another business's address does not appear when the account syncs several businesses. Needs the account-level sync (link_google_business_profile). Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | Tecrübe campaign id (list_campaigns) or Google Ads campaign id |
label_filtersOpcional | array<string> | Business Profile labels (OR) |
listing_idsOpcional | array<string> | Business Profile listing ids (OR) |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
remove_google_audience
EscrituraIrreversible2 créditosPermanently remove a Google Ads audience list (Customer Match, website, lookalike). A list still used by a campaign is rejected by Google; use only when the user explicitly asked for it. Applied to Google Ads directly when the user asks (the user's request is the consent); the result shows the preview (current → new), only with a connected account (dry run otherwise) and it can be undone with undo_action.
La descripción de esta herramienta aún no está traducida; se muestra el texto original en inglés que ve el asistente.
| Parámetro | Tipo | Descripción |
|---|---|---|
user_list_idObligatorio | string | audience (user list) id from list_audiences |
nameOpcional | string | list name, shown in the approval |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_lookalike_audience
Escritura2 créditosCrea una audiencia similar (Demand Gen) a partir de listas semilla para los países y el nivel de alcance indicados. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
seed_user_list_idsObligatorio | array<string> | — |
country_codesObligatorio | array<string> | — |
expansion_levelOpcional | NARROW | BALANCED | BROAD | — |
membership_daysOpcional | integer (1–540) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_website_audience
Escritura2 créditosCrea una lista de remarketing basada en reglas con los visitantes del sitio cuya URL de página coincide (requiere la etiqueta de Google en el sitio); los visitantes anteriores se incluyen de entrada. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
nameObligatorio | string | — |
url_containsObligatorio | any | — |
string_operatorOpcional | CONTAINS | EQUALS | STARTS_WITH | ENDS_WITH | — |
membership_daysOpcional | integer (1–540) | — |
lookback_daysOpcional | integer (1–540) | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_audience_targeting
Escritura2 créditosVincula una lista de audiencia a una campaña o grupo de anuncios (o la quita), con la opción de definir observación frente a segmentación y un modificador de puja. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
audienceObligatorio | string | id de lista de usuarios (list_audiences) |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id de grupo de anuncios de Google Ads (list_google_ad_groups) |
actionOpcional | add | remove | — |
modeOpcional | observation | targeting | — |
bid_modifierOpcional | number | multiplicador, 1.2 = +20 % |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_campaign_settings
Escritura2 créditosLee (sin otro argumento) o cambia la configuración de la campaña: opción de ubicación por presencia o interés, socios de búsqueda, expansión a Display, plantilla de seguimiento, declaración de anuncios políticos de la UE, AI Max for Search. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
geo_target_typeOpcional | PRESENCE | PRESENCE_OR_INTEREST | — |
search_partnersOpcional | boolean | — |
display_expansionOpcional | boolean | — |
tracking_url_templateOpcional | string | — |
eu_political_adsOpcional | boolean | — |
ai_maxOpcional | boolean | AI Max for Search |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_google_ads_account
EscrituraIrreversible2 créditosAbre una nueva cuenta de cliente bajo una cuenta de administrador (MCC) que gestiona el usuario conectado. Siempre espera aprobación explícita; la moneda y la zona horaria son permanentes. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
manager_customer_idObligatorio | string | — |
nameObligatorio | string | — |
currency_codeObligatorio | string | — |
time_zoneObligatorio | string | — |
tracking_url_templateOpcional | string | — |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
create_lead_form
Escritura2 créditosCrea un recurso de formulario de clientes potenciales (el formulario dentro del anuncio) con campos estándar, preguntas personalizadas, pantalla de agradecimiento y entrega opcional por webhook, y lo vincula a una campaña o grupo de anuncios. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
business_nameObligatorio | string | — |
headlineObligatorio | string | — |
descriptionObligatorio | string | — |
privacy_policy_urlObligatorio | string | — |
final_urlObligatorio | string | — |
ctaOpcional | LEARN_MORE | GET_QUOTE | APPLY_NOW | SIGN_UP | CONTACT_US | SUBSCRIBE | DOWNLOAD | BOOK_NOW | GET_OFFER | REGISTER | GET_INFO | REQUEST_DEMO | JOIN_NOW | GET_STARTED | — |
cta_descriptionOpcional | string | — |
fieldsOpcional | array<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE> | — |
questionsOpcional | array<any> | — |
post_submit_headlineOpcional | string | — |
post_submit_descriptionOpcional | string | — |
post_submit_ctaOpcional | VISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW | — |
webhook_urlOpcional | string | — |
webhook_keyOpcional | string | — |
campaign_idOpcional | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
ad_group_idOpcional | string | id del grupo de anuncios de Google Ads (list_google_ad_groups) |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_business_logo
Escritura2 créditosSustituye el logotipo de la empresa que se muestra en los anuncios de una campaña. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
asset_idObligatorio | string | id de recurso de imagen 1:1 o URL de imagen |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_business_name
Escritura2 créditosDefine o corrige el nombre de la empresa que se muestra en los anuncios de una campaña. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
textObligatorio | string | ≤25 caracteres |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_campaign_proximity
Escritura2 créditosLista, añade o quita objetivos de radio (círculo de lat/lng) en una campaña. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
actionOpcional | list | add | remove | — |
latOpcional | number | — |
lngOpcional | number | — |
radiusOpcional | number | — |
unitsOpcional | KILOMETERS | MILES | — |
pointsOpcional | array<object> | — |
criterion_idOpcional | string | — |
criterion_idsOpcional | array<string> | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
manage_device_targeting
Escritura2 créditosDefine el ajuste de puja de una campaña para un dispositivo (o -100 % para dejar de mostrarse en él). Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
campaign_idObligatorio | string | id de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads |
deviceObligatorio | MOBILE | DESKTOP | TABLET | CONNECTED_TV | — |
bid_modifier_pctObligatorio | number | -90..900, o -100 para excluir |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
set_call_reporting
Escritura2 créditosActiva/desactiva los informes de llamadas y de conversiones de llamada a nivel de cuenta y elige la acción de conversión de llamada. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
call_reportingOpcional | boolean | — |
call_conversionOpcional | boolean | — |
call_conversion_action_idOpcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.
update_pmax_asset_group
EscrituraIrreversible2 créditosCambia la URL final, el nombre, las rutas visibles o el estado de un grupo de recursos de Performance Max; REMOVED es permanente y espera una aprobación explícita. Crea un elemento de aprobación con vista previa (actual → nuevo); se aplica en Google Ads tras la aprobación del usuario (de inmediato solo si la política de aprobación de la cuenta para ese tipo es explícitamente 'hazlo tú mismo') y solo con una cuenta conectada (si no, simulación).
| Parámetro | Tipo | Descripción |
|---|---|---|
asset_group_idObligatorio | string | — |
final_urlOpcional | string | — |
nameOpcional | string | — |
statusOpcional | ENABLED | PAUSED | REMOVED | — |
path1Opcional | string | — |
path2Opcional | string | — |
customer_idOpcional | string | optional: run in this Google Ads client account (customer id from list_google_ads_accounts) for this call only; the saved account selection does not change |
Herramienta de escritura: la llamada genera primero una vista previa; el cambio llega a la plataforma solo tras tu aprobación.