Saltar al contenido
Tecrübetecrube.com
Herramientas del asistente · Configuración y campañas

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éditos

Cuentas 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_device_report

Lectura2 créditos

Rendimiento 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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
compare_previousOpcionalboolean—
customer_idOpcionalstringoptional: 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éditos

Recomendaciones 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ámetroTipoDescripción
typesOpcionalarray<string>tipos de recomendación, p. ej. KEYWORD, CAMPAIGN_BUDGET, SITELINK_ASSET
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
include_dismissedOpcionalboolean—
limitOpcionalinteger (1–10000)—
customer_idOpcionalstringoptional: 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éditos

Ideas 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ámetroTipoDescripción
seed_keywordsOpcionalarray<string>—
urlOpcionalstring—
locationOpcionalstringnombres de ciudad/región, separados por comas
countryOpcionalstringcódigo ISO, por defecto TR
languageOpcionalstringtr, en, de, fr, es, ar, ru
limitOpcionalinteger (10–500)—
customer_idOpcionalstringoptional: 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éditos

Exclusiones de IP en campañas de Google Ads. Requiere una cuenta de Google Ads conectada; si no, devuelve connected=false, nunca cifras inventadas.

ParámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Grupos 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Listas 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ámetroTipoDescripción
list_idOpcionalstringdevolver también las palabras clave de esta lista
customer_idOpcionalstringoptional: 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éditos

Anuncios 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Acciones 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ámetroTipoDescripción
daysOpcionalinteger (1–365)also return conversions recorded per action in this window
statusOpcionalstringonly this status, e.g. ENABLED or REMOVED
searchOpcionalstringname contains
include_removedOpcionalbooleanalso list removed actions (to verify a removal)
limitOpcionalinteger (1–200)default 50
customer_idOpcionalstringoptional: 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éditos

Grupos 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
asset_group_idOpcionalstring—
signalsOpcionalbooleanalso return audience signals and search themes
customer_idOpcionalstringoptional: 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éditos

Campañ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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
customer_idOpcionalstringoptional: 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éditos

Campañ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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
customer_idOpcionalstringoptional: 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éditos

Informe 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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
threshold_rateOpcionalnumbertasa de clics no válidos sospechosa como fracción, por defecto 0.10
customer_idOpcionalstringoptional: 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éditos

Cuentas 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éditos

Productos 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada
statusOpcionalall | disapproved | pending | approved | issuesissues = cualquier problema a nivel de artículo o país rechazado
queryOpcionalstringfragmento del título o del id de oferta
limitOpcionalinteger (1–1000)—

get_merchant_product_issues

Lectura1 créditos

Problemas 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada
product_idOpcionalstringp. ej. online~tr~TR~SKU123 (de list_merchant_products)
offer_idOpcionalstring—

merchant_feed_status

Lectura1 créditos

Fuentes 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ámetroTipoDescripción
account_idOpcionalstringid de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada

get_ad_details

Lectura1 créditos

Contenido 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
ad_idOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Segmentació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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
customer_idOpcionalstringoptional: 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éditos

Toda 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ámetroTipoDescripción
asset_typeOpcionalTEXT | IMAGE | YOUTUBE_VIDEO | SITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | LEAD_FORM | BUSINESS_MESSAGE | MOBILE_APP | CALL_TO_ACTION | LOCATION | PAGE_FEED—
limitOpcionalinteger (1–1000)—
include_usageOpcionalbooleanlista también qué campañas/grupos de anuncios usan cada recurso
include_approvalOpcionalbooleanañade el estado de aprobación/revisión de políticas
customer_idOpcionalstringoptional: 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éditos

Resultados 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
daysOpcionalinteger (1–365)—
limitOpcionalinteger (1–1000)—
min_impressionsOpcionalinteger (0–…)—
customer_idOpcionalstringoptional: 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éditos

Mé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ámetroTipoDescripción
keywordsObligatorioarray<string>—
language_idOpcionalstringid de constante de idioma de Google, por defecto 1037 (turco)
languageOpcionalstringalternativa con código de idioma (tr, en…)
geo_idsOpcionalarray<string>id de constantes de segmentación geográfica (geo_target_search), por defecto 2792 (Turquía)
start_monthOpcionalstringYYYY-MM
end_monthOpcionalstringYYYY-MM
customer_idOpcionalstringoptional: 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éditos

Nivel 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
daysOpcionalinteger (1–90)—
limitOpcionalinteger (1–500)—
customer_idOpcionalstringoptional: 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éditos

Todas 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Sugerencias 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ámetroTipoDescripción
daysOpcionalinteger (1–90)—
min_wasteOpcionalnumbergasto mínimo por término
limitOpcionalinteger (1–500)—
customer_idOpcionalstringoptional: 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éditos

Revisió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ámetroTipoDescripción
daysOpcionalinteger (1–90)—
customer_idOpcionalstringoptional: 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éditos

Rendimiento 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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
field_typeOpcionalSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGE—
limitOpcionalinteger (1–1000)—
customer_idOpcionalstringoptional: 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éditos

Programació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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Detalles 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ámetroTipoDescripción
conversion_action_idsOpcionalarray<string>—
customer_idOpcionalstringoptional: 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éditos

Recursos 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
customer_idOpcionalstringoptional: 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éditos

Objetivos 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Objetivos 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ámetroTipoDescripción
customer_idOpcionalstringoptional: 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éditos

Gasto 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ámetroTipoDescripción
threshold_pctOpcionalnumber (1–100)desviación que activa una alerta, por defecto 10
customer_idOpcionalstringoptional: 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éditos

Cuota 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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
levelOpcionalcampaign | ad_group—
customer_idOpcionalstringoptional: 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éditos

Listas 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ámetroTipoDescripción
limitOpcionalinteger (1–1000)—
definitionOpcionalbooleanincluye la definición de regla / semilla de la lista
searchOpcionalstringname contains, or exact list id
customer_idOpcionalstringoptional: 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éditos

Lista 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ámetroTipoDescripción
actionOpcionallistsolo list; para finalizar o aplicar, manage_experiment
customer_idOpcionalstringoptional: 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éditos

Diagnó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ámetroTipoDescripción
campaign_idOpcionalstringid 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
relatedOpcionalbooleanpor defecto true: también las recomendaciones de la campaña y los cambios de los últimos 14 días
customer_idOpcionalstringoptional: 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éditos

Anuncios 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ámetroTipoDescripción
only_problemsOpcionalbooleanpor defecto true: solo anuncios rechazados / limitados
limitOpcionalinteger (1–1000)—
customer_idOpcionalstringoptional: 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éditos

Clientes 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ámetroTipoDescripción
daysOpcionalinteger (1–90)—
asset_idOpcionalstringid del recurso de formulario de clientes potenciales
limitOpcionalinteger (1–1000)—
customer_idOpcionalstringoptional: 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éditos

Business 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ámetroTipoDescripción
customer_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
customer_idObligatoriostringid 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éditos

Aplica 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ámetroTipoDescripción
recommendationsObligatorioarray<string>nombres de recurso de list_google_ads_recommendations
actionOpcionalapply | dismissdefault apply
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumbermoneda de la cuenta
locationsOpcionalarray<string>nombres de ciudad/región/país; por defecto: la ciudad del perfil de marca
location_idsOpcionalarray<string>ids de constantes de segmentación geográfica de Google
countryOpcionalstring—
languagesOpcionalarray<string>códigos de idioma (tr, en…) o ids de idioma de Google; por defecto turco
bid_strategyOpcionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
cpc_bidOpcionalnumberCPC predeterminado del grupo de anuncios
keywordsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
ad_group_nameOpcionalstring—
search_partnersOpcionalboolean—
end_dateOpcionalstringYYYY-MM-DD
goalOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumber—
final_urlObligatoriostring—
business_nameObligatoriostring≤25 caracteres
headlinesObligatorioarray<string>3-15, ≤30 caracteres
long_headlinesObligatorioarray<string>1-5, ≤90 caracteres
descriptionsObligatorioarray<string>2-5, ≤90 caracteres
marketing_imagesObligatorioarray<string>horizontal 1.91:1, al menos 1
square_marketing_imagesObligatorioarray<string>1:1, al menos 1
logo_imagesObligatorioarray<string>logotipo 1:1, al menos 1
portrait_marketing_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
landscape_logo_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
bid_strategyOpcionalmaximize_conversions | maximize_conversion_value—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
locationsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
asset_group_nameOpcionalstring—
end_dateOpcionalstring—
goalOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumber—
final_urlObligatoriostring—
business_nameObligatoriostring≤25 caracteres
headlinesObligatorioarray<string>1-5, ≤30 caracteres
long_headlineObligatoriostring≤90 caracteres
descriptionsObligatorioarray<string>1-5, ≤90 caracteres
marketing_imagesObligatorioarray<string>horizontal 1.91:1, al menos 1
square_marketing_imagesOpcionalarray<string>1:1, al menos 1 (si falta, se recorta de la imagen horizontal)
logo_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
landscape_logo_imagesOpcionalarray<string>image URLs (https) or Studio /medya files
bid_strategyOpcionalmaximize_conversions | target_cpa | maximize_clicks | manual_cpc—
target_cpaOpcionalnumber—
max_cpcOpcionalnumber—
cpc_bidOpcionalnumber—
locationsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
ad_group_nameOpcionalstring—
end_dateOpcionalstring—
goalOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumber—
merchant_idObligatoriostring—
campaign_priorityOpcional0 | 1 | 2—
feed_labelOpcionalstring—
enable_localOpcionalboolean—
bid_strategyOpcionalmanual_cpc | maximize_clicks | target_roas | maximize_conversion_value—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
cpc_bidOpcionalnumber—
locationsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
ad_group_nameOpcionalstring—
end_dateOpcionalstring—
goalOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Ajusta 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ámetroTipoDescripción
actionOpcionalcreate | remove—
operationOpcionalADD | MULTIPLY | SET—
valueOpcionalnumberpara MULTIPLY 0,5-10; para ADD/SET mayor que 0 (en la moneda de la cuenta)
device_typesOpcionalarray<string>e.g. MOBILE, DESKTOP, TABLET
geo_target_idsOpcionalarray<string>—
geo_match_typeOpcionalstring—
user_list_idsOpcionalarray<string>—
campaign_idOpcionalstringTecrübe campaign id (list_campaigns) or Google Ads campaign id
resource_nameOpcionalstringfor action=remove
customer_idOpcionalstringoptional: 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éditos

Renombra, 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
nameOpcionalstring—
statusOpcionalpause | enable—
end_dateOpcionalstring | nullYYYY-MM-DD, o null para ejecutarse indefinidamente
customer_idOpcionalstringoptional: 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éditos

Renombra 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ámetroTipoDescripción
renamesOpcionalarray<object>—
campaign_idsOpcionalarray<string>—
patternOpcionalstringpatrón de nombres con {name}, {channel}, {id}, p. ej. 'Brand | {channel} | {name}'
findOpcionalstring—
replaceOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Elimina 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
strategyObligatoriomaximize_conversions | maximize_conversion_value | target_cpa | target_roas | manual_cpc | maximize_clicks | target_impression_share—
target_cpaOpcionalnumbermoneda de la cuenta
target_roasOpcionalnumberproporción, 4.0 = 400 %
max_cpcOpcionalnumbertecho de CPC para maximize_clicks
impression_share_locationOpcionalANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentOpcionalnumber (1–100)—
customer_idOpcionalstringoptional: 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éditos

Establece 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
replaceOpcionalbooleaneliminar primero la programación existente
scheduleObligatorioarray<object>—
customer_idOpcionalstringoptional: 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éditos

Segmenta 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
locationsOpcionalarray<string>nombres, p. ej. İstanbul, Ankara
location_idsOpcionalarray<string>—
countryOpcionalstringcódigo ISO orientativo, por defecto TR
excludeOpcionalboolean—
replaceOpcionalbooleaneliminar primero las ubicaciones segmentadas existentes
bid_adjustmentOpcionalnumberporcentaje
languagesOpcionalarray<string>language codes (tr, en…) or Google language ids to target
customer_idOpcionalstringoptional: 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éditos

Fusió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ámetroTipoDescripción
target_campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
source_campaign_idsObligatorioarray<string>—
move_budgetOpcionalbooleansumar los presupuestos diarios de origen al destino (por defecto true)
new_daily_budgetOpcionalnumberpresupuesto diario de destino explícito en lugar de la suma
customer_idOpcionalstringoptional: 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éditos

Excluye 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ipsObligatorioarray<string>direcciones IPv4/IPv6 o bloques CIDR
customer_idOpcionalstringoptional: 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éditos

Quita 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ipsObligatorioarray<string>direcciones IPv4/IPv6 o bloques CIDR que se dejan de excluir
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
nameObligatoriostring—
cpc_bidOpcionalnumber—
keywordsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
customer_idOpcionalstringoptional: 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éditos

Pausa 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ámetroTipoDescripción
ad_group_idsOpcionalarray<string>—
ad_group_idOpcionalstring—
statusObligatoriopause | enable—
customer_idOpcionalstringoptional: 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éditos

Pausa 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ámetroTipoDescripción
ad_group_idsObligatorioarray<string>—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
ad_group_idObligatoriostring—
keywordsObligatorioarray<any>—
customer_idOpcionalstringoptional: 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éditos

Pausa/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ámetroTipoDescripción
ad_group_idObligatoriostring—
keyword_idObligatoriostring—
statusOpcionalpause | enable—
bidOpcionalnumber—
match_typeOpcionalBROAD | PHRASE | EXACT—
customer_idOpcionalstringoptional: 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éditos

Elimina 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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
shared_list_idOpcionalstring—
keywordsOpcionalarray<string>—
criterion_idsOpcionalarray<string>negative criterion ids (list_negative_keywords) instead of / in addition to text
match_typeOpcionalBROAD | PHRASE | EXACT—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
list_idOpcionalstring—
list_nameOpcionalstringcrea una lista nueva cuando no se indica list_id
keywordsObligatorioarray<any>—
attach_campaign_idsOpcionalarray<string>—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
ad_group_idObligatoriostring—
headlinesObligatorioarray<any>—
descriptionsObligatorioarray<any>—
final_urlObligatoriostring—
path1Opcionalstring—
path2Opcionalstring—
final_mobile_urlOpcionalstring—
tracking_url_templateOpcionalstring—
statusOpcionalenable | pause—
customer_idOpcionalstringoptional: 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éditos

Renueva 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ámetroTipoDescripción
ad_group_idObligatoriostring—
ad_idObligatoriostring—
replace_low_performingOpcionalboolean—
remove_headlinesOpcionalarray<string>—
add_headlinesOpcionalarray<any>—
remove_descriptionsOpcionalarray<string>—
add_descriptionsOpcionalarray<any>—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
pause_oldOpcionalbooleanpor defecto true
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
calloutsObligatorioarray<string>≤25 caracteres cada uno
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
categoryOpcionalDEFAULT | 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_typeOpcionalone | many—
primary_for_goalOpcionalboolean—
default_valueOpcionalnumber—
currencyOpcionalstring—
always_use_default_valueOpcionalboolean—
click_through_window_daysOpcionalinteger (1–90)—
view_through_window_daysOpcionalinteger (1–30)—
phone_call_duration_secondsOpcionalinteger (0–10800)—
typeOpcionalWEBPAGE | UPLOAD_CLICKS | UPLOAD_CALLS | AD_CALL | WEBSITE_CALL | CLICK_TO_CALLdefault WEBPAGE; UPLOAD_CLICKS for offline conversion upload
customer_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
conversion_action_idObligatoriostring—
nameOpcionalstring—
statusOpcionalenable | hide | remove | ENABLED | HIDDEN | REMOVED—
categoryOpcionalDEFAULT | 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_typeOpcionalone | many—
primary_for_goalOpcionalboolean—
default_valueOpcionalnumber—
currencyOpcionalstring—
always_use_default_valueOpcionalboolean—
click_through_window_daysOpcionalinteger (1–90)—
view_through_window_daysOpcionalinteger (1–30)—
phone_call_duration_secondsOpcionalinteger (0–10800)—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
asset_group_idObligatoriostring—
headlinesOpcionalarray<string>—
long_headlinesOpcionalarray<string>—
descriptionsOpcionalarray<string>—
business_nameOpcionalstring—
marketing_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
square_marketing_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
logo_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
portrait_marketing_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
landscape_logo_imagesOpcionalarray<string>URL de imagen (https) o archivos de Studio /medya
customer_idOpcionalstringoptional: 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éditos

Sube 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ámetroTipoDescripción
imagesObligatorioarray<any>URL https o archivos de Studio /medya (JPEG/PNG/GIF, ≤5120 KB), hasta 20
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumbermoneda de la cuenta
final_urlObligatoriostring—
business_nameObligatoriostring≤25 caracteres
headlinesObligatorioarray<string>1-5, ≤40 caracteres
descriptionsObligatorioarray<string>1-5, ≤90 caracteres
marketing_imagesOpcionalarray<string>horizontal 1.91:1: URL a subir o ids de recurso existentes
square_marketing_imagesOpcionalarray<string>1:1: URL o ids de recurso
portrait_marketing_imagesOpcionalarray<string>4:5: URL o ids de recurso
logo_imagesObligatorioarray<string>logotipo 1:1, al menos 1: URL o ids de recurso
call_to_actionOpcionalstringp. ej. Learn more, Shop now (≤15 caracteres)
bid_strategyOpcionalmaximize_conversions | maximize_conversion_value | target_cpa | target_roas | maximize_clicks—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
audience_idsOpcionalarray<string>ids de audiencia de Google Ads (Gestor de audiencias) para segmentar el grupo de anuncios; vacío = amplia
locationsOpcionalarray<string>—
location_idsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
ad_group_nameOpcionalstring—
end_dateOpcionalstringYYYY-MM-DD
goalOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
daily_budgetObligatorionumbermoneda de la cuenta
app_idObligatoriostringid numérico de app de Apple (p. ej. 284815942) o nombre de paquete Android (p. ej. com.example.app)
app_storeObligatorioapple | google—
goalOpcionalinstalls | installs_no_target | in_app_actions | in_app_actions_cpa | value | pre_registrationinstalls = 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_cpaOpcionalnumbercoste objetivo por instalación / acción en la app
target_roasOpcionalnumber—
conversion_action_idsOpcionalarray<string>acciones de conversión en la app para objetivos in_app / value (list_google_conversion_actions)
headlinesObligatorioarray<string>2-5, ≤30 caracteres
descriptionsObligatorioarray<string>1-5, ≤90 caracteres
imagesOpcionalarray<string>URL de imágenes opcionales a subir o ids de recurso existentes
video_asset_idsOpcionalarray<string>ids de recursos de vídeo de YouTube existentes
locationsOpcionalarray<string>—
location_idsOpcionalarray<string>—
countryOpcionalstring—
languagesOpcionalarray<string>—
ad_group_nameOpcionalstring—
end_dateOpcionalstringYYYY-MM-DD
goal_noteOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Reemplaza 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ámetroTipoDescripción
ad_idObligatoriostring—
headlinesOpcionalarray<string>2-5, up to 30 characters
descriptionsOpcionalarray<string>1-5, up to 90 characters
customer_idOpcionalstringoptional: 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éditos

Protecció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ámetroTipoDescripción
daysOpcionalinteger (1–365)—
start_dateOpcionalstringYYYY-MM-DD
end_dateOpcionalstringYYYY-MM-DD
threshold_rateOpcionalnumber—
campaign_idsOpcionalarray<string>campañas explícitas; por defecto: las campañas marcadas por el informe de clics no válidos
ipsOpcionalarray<string>direcciones IPv4/IPv6 o bloques CIDR de tus propios registros de servidor/analítica
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
offer_idObligatoriostring—
content_languageOpcionalstringpor defecto tr
feed_labelOpcionalstringpor defecto TR
account_idOpcionalstringid de la cuenta de Merchant Center; opcional cuando el usuario tiene una sola cuenta o hay una seleccionada
data_sourceOpcionalstringid de la fuente de datos; por defecto: la fuente de datos de productos API/principal de la cuenta
titleOpcionalstring—
descriptionOpcionalstring—
linkOpcionalstring—
image_linkOpcionalstring—
priceOpcionalnumber—
sale_priceOpcionalnumber—
currencyOpcionalstringISO, por defecto TRY
availabilityOpcionalin stock | out of stock | preorder | backorder—
conditionOpcionalnew | refurbished | used—
brandOpcionalstring—
gtinOpcionalstring—
googleProductCategoryOpcionalstring—
imageLinkOpcionalstringAlias of image_link
channelOpcionalONLINE | LOCALdefault ONLINE
attributesOpcionalobjectotros 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éditos

Finaliza 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ámetroTipoDescripción
experiment_idObligatoriostring—
actionObligatorioend | promote—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
ad_group_idObligatoriostringid del grupo de anuncios de Google Ads (list_google_ad_groups)
youtube_videoObligatoriostringURL de YouTube o id de 11 caracteres, o un id de recurso de vídeo existente
headlinesObligatorioarray<string>1-5, ≤40
long_headlinesObligatorioarray<string>1-5, ≤90
descriptionsObligatorioarray<string>1-5, ≤90
business_nameObligatoriostring—
final_urlObligatoriostring—
logo_asset_idObligatoriostringid de recurso de logotipo 1:1 o URL de imagen
call_to_actionOpcionalLEARN_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_nameOpcionalstring—
statusOpcionalenable | pause—
customer_idOpcionalstringoptional: 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éditos

Duplica 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ámetroTipoDescripción
ad_group_idsObligatorioarray<string>—
target_campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
new_nameOpcionalstring—
name_suffixOpcionalstring—
statusOpcionalpause | enablepor defecto pause
cpc_bidOpcionalnumber—
include_keywordsOpcionalboolean—
include_negativesOpcionalboolean—
include_adsOpcionalboolean—
include_assetsOpcionalboolean—
include_audiencesOpcionalboolean—
customer_idOpcionalstringoptional: 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éditos

Segmentació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ámetroTipoDescripción
ad_group_idObligatoriostringid de grupo de anuncios de Google Ads (list_google_ad_groups)
locationsOpcionalarray<string>—
location_idsOpcionalarray<string>—
negative_locationsOpcionalarray<string>—
negative_location_idsOpcionalarray<string>—
languagesOpcionalarray<string>—
countryOpcionalstring—
modeOpcionaladd | replace—
customer_idOpcionalstringoptional: 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éditos

Renombra 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ámetroTipoDescripción
ad_group_idObligatoriostringid de grupo de anuncios de Google Ads (list_google_ad_groups)
nameOpcionalstring—
cpc_bidOpcionalnumber—
statusOpcionalpause | enable—
customer_idOpcionalstringoptional: 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éditos

Activa, 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ámetroTipoDescripción
ad_group_idObligatoriostringid de grupo de anuncios de Google Ads (list_google_ad_groups)
ad_idObligatoriostring—
statusObligatorioENABLED | PAUSED | REMOVED—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
asset_group_idObligatoriostring—
headlinesOpcionalarray<string>—
long_headlinesOpcionalarray<string>—
descriptionsOpcionalarray<string>—
remove_resource_namesOpcionalarray<string>vínculos de recursos del grupo de recursos de list_google_asset_groups
customer_idOpcionalstringoptional: 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éditos

Edita 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ámetroTipoDescripción
ad_idObligatoriostring—
headlinesOpcionalarray<any>—
descriptionsOpcionalarray<any>—
add_headlinesOpcionalarray<any>—
remove_headlinesOpcionalarray<string>—
add_descriptionsOpcionalarray<any>—
remove_descriptionsOpcionalarray<string>—
headline_pinsOpcionalobject{texto: campo de fijación} — una cadena vacía quita la fijación
description_pinsOpcionalobject{texto: campo de fijación} — una cadena vacía quita la fijación
final_urlOpcionalstring—
path1Opcionalstring—
path2Opcionalstring—
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
textOpcionalstring—
keywordsOpcionalarray<any>—
match_typeOpcionalBROAD | PHRASE | EXACT—
skip_existingOpcionalbooleanpor defecto true
customer_idOpcionalstringoptional: 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éditos

Pausa / 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ámetroTipoDescripción
ad_group_idObligatoriostringid de grupo de anuncios de Google Ads (list_google_ad_groups)
criterion_idsObligatorioarray<string>—
actionObligatoriopause | enable | remove | set_bid | set_url—
cpc_bidOpcionalnumber—
final_urlOpcionalstring—
final_mobile_urlOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Gestiona 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ámetroTipoDescripción
actionObligatoriocreate | add_keywords | remove_keywords | attach | detach | rename | delete—
shared_set_idOpcionalstring—
nameOpcionalstring—
keywordsOpcionalarray<any>—
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
campaign_idsOpcionalarray<string>—
customer_idOpcionalstringoptional: 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éditos

Descarta 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ámetroTipoDescripción
resource_namesObligatorioarray<string>de list_google_ads_recommendations
customer_idOpcionalstringoptional: 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éditos

Añ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ámetroTipoDescripción
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid de grupo de anuncios de Google Ads (list_google_ad_groups)
sitelinksOpcionalarray<object>—
calloutsOpcionalarray<string>—
snippet_headerOpcionalstringp. ej. Services, Brands, Types, Destinations
snippet_valuesOpcionalarray<string>—
phone_numberOpcionalstring—
phone_countryOpcionalstring—
whatsapp_numberOpcionalstring—
whatsapp_countryOpcionalstring—
whatsapp_greetingOpcionalstring—
whatsapp_ctaOpcionalAPPLY_NOW | BOOK_NOW | CONTACT_US | GET_INFO | GET_OFFER | GET_QUOTE | GET_STARTED | LEARN_MORE—
whatsapp_cta_textOpcionalstring—
promotionsOpcionalarray<object>—
pricesOpcionalobject—
customer_idOpcionalstringoptional: 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éditos

Desvincula 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ámetroTipoDescripción
resource_namesOpcionalarray<string>nombres de recurso de vínculo de list_extension_assets
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
field_typeOpcionalSITELINK | CALLOUT | STRUCTURED_SNIPPET | CALL | PROMOTION | PRICE | BUSINESS_MESSAGE | MOBILE_APP | HOTEL_CALLOUT | LEAD_FORM | BUSINESS_NAME | BUSINESS_LOGO | AD_IMAGEcon campaign_id: quita todos los vínculos de este tipo
customer_idOpcionalstringoptional: 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éditos

Estrategias 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ámetroTipoDescripción
actionOpcionallist | create | update | assign—
nameOpcionalstring—
strategyOpcionaltarget_cpa | target_roas | maximize_clicks | maximize_conversions | maximize_conversion_value | target_impression_share—
target_cpaOpcionalnumber—
target_roasOpcionalnumber—
max_cpcOpcionalnumber—
min_cpcOpcionalnumber—
impression_share_locationOpcionalANYWHERE_ON_PAGE | TOP_OF_PAGE | ABSOLUTE_TOP_OF_PAGE—
impression_share_percentOpcionalnumber (1–100)—
bidding_strategy_idOpcionalstring—
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Avisa 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ámetroTipoDescripción
actionOpcionalcreate | remove—
typeObligatorioseasonality | data_exclusion—
nameOpcionalstring—
scopeOpcionalCAMPAIGN | CHANNEL—
campaign_idsOpcionalarray<string>—
channel_typesOpcionalarray<string>—
devicesOpcionalarray<string>—
start_date_timeOpcionalstringAAAA-MM-DD o AAAA-MM-DD HH:MM:SS, en la zona horaria de la cuenta
end_date_timeOpcionalstringAAAA-MM-DD o AAAA-MM-DD HH:MM:SS, en la zona horaria de la cuenta
conversion_rate_modifierOpcionalnumber (0.1–10)solo ajuste estacional: 1,2 = se esperan un 20 % más de conversiones
resource_nameOpcionalstringfor action=remove
customer_idOpcionalstringoptional: 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éditos

Muestra 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ámetroTipoDescripción
actionOpcionallist | enable | disable—
typesOpcionalarray<string>—
customer_idOpcionalstringoptional: 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éditos

Convierte 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ámetroTipoDescripción
categoryObligatorioDEFAULT | 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—
originOpcionalWEBSITE | GOOGLE_HOSTED | APP | CALL_FROM_ADS | STORE | YOUTUBE_HOSTED | LOCAL_SERVICES_ADS—
roleObligatorioprimary | secondary—
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
customer_idOpcionalstringoptional: 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éditos

Crea, 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ámetroTipoDescripción
goal_idOpcionalstringomítelo para crear un objetivo nuevo
conversion_actionsOpcionalarray<string>—
nameOpcionalstring—
removeOpcionalboolean—
customer_idOpcionalstringoptional: 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éditos

Sube 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ámetroTipoDescripción
conversion_actionObligatoriostringid de una acción de conversión UPLOAD_CLICKS
currency_codeOpcionalstring—
conversionsObligatorioarray<object>—
customer_idOpcionalstringoptional: 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éditos

Retracta (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ámetroTipoDescripción
conversion_actionObligatoriostring—
currency_codeOpcionalstring—
adjustmentsObligatorioarray<object>—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
membership_daysOpcionalinteger (1–540)—
upload_key_typeOpcionalCONTACT_INFO | CRM_ID | MOBILE_ADVERTISING_ID—
customer_idOpcionalstringoptional: 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éditos

Show 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ámetroTipoDescripción
campaign_idObligatoriostringTecrübe campaign id (list_campaigns) or Google Ads campaign id
label_filtersOpcionalarray<string>Business Profile labels (OR)
listing_idsOpcionalarray<string>Business Profile listing ids (OR)
customer_idOpcionalstringoptional: 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éditos

Permanently 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ámetroTipoDescripción
user_list_idObligatoriostringaudience (user list) id from list_audiences
nameOpcionalstringlist name, shown in the approval
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
seed_user_list_idsObligatorioarray<string>—
country_codesObligatorioarray<string>—
expansion_levelOpcionalNARROW | BALANCED | BROAD—
membership_daysOpcionalinteger (1–540)—
customer_idOpcionalstringoptional: 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éditos

Crea 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ámetroTipoDescripción
nameObligatoriostring—
url_containsObligatorioany—
string_operatorOpcionalCONTAINS | EQUALS | STARTS_WITH | ENDS_WITH—
membership_daysOpcionalinteger (1–540)—
lookback_daysOpcionalinteger (1–540)—
customer_idOpcionalstringoptional: 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éditos

Vincula 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ámetroTipoDescripción
audienceObligatoriostringid de lista de usuarios (list_audiences)
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid de grupo de anuncios de Google Ads (list_google_ad_groups)
actionOpcionaladd | remove—
modeOpcionalobservation | targeting—
bid_modifierOpcionalnumbermultiplicador, 1.2 = +20 %
customer_idOpcionalstringoptional: 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éditos

Lee (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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
geo_target_typeOpcionalPRESENCE | PRESENCE_OR_INTEREST—
search_partnersOpcionalboolean—
display_expansionOpcionalboolean—
tracking_url_templateOpcionalstring—
eu_political_adsOpcionalboolean—
ai_maxOpcionalbooleanAI Max for Search
customer_idOpcionalstringoptional: 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éditos

Abre 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ámetroTipoDescripción
manager_customer_idObligatoriostring—
nameObligatoriostring—
currency_codeObligatoriostring—
time_zoneObligatoriostring—
tracking_url_templateOpcionalstring—

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éditos

Crea 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ámetroTipoDescripción
business_nameObligatoriostring—
headlineObligatoriostring—
descriptionObligatoriostring—
privacy_policy_urlObligatoriostring—
final_urlObligatoriostring—
ctaOpcionalLEARN_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_descriptionOpcionalstring—
fieldsOpcionalarray<FULL_NAME | FIRST_NAME | LAST_NAME | EMAIL | PHONE_NUMBER | POSTAL_CODE | STREET_ADDRESS | CITY | REGION | COUNTRY | WORK_EMAIL | COMPANY_NAME | WORK_PHONE | JOB_TITLE>—
questionsOpcionalarray<any>—
post_submit_headlineOpcionalstring—
post_submit_descriptionOpcionalstring—
post_submit_ctaOpcionalVISIT_SITE | DOWNLOAD | LEARN_MORE | SHOP_NOW—
webhook_urlOpcionalstring—
webhook_keyOpcionalstring—
campaign_idOpcionalstringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
ad_group_idOpcionalstringid del grupo de anuncios de Google Ads (list_google_ad_groups)
customer_idOpcionalstringoptional: 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éditos

Define 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
textObligatoriostring≤25 caracteres
customer_idOpcionalstringoptional: 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éditos

Lista, 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
actionOpcionallist | add | remove—
latOpcionalnumber—
lngOpcionalnumber—
radiusOpcionalnumber—
unitsOpcionalKILOMETERS | MILES—
pointsOpcionalarray<object>—
criterion_idOpcionalstring—
criterion_idsOpcionalarray<string>—
customer_idOpcionalstringoptional: 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éditos

Define 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ámetroTipoDescripción
campaign_idObligatoriostringid de campaña de Tecrübe (list_campaigns) o id de campaña de Google Ads
deviceObligatorioMOBILE | DESKTOP | TABLET | CONNECTED_TV—
bid_modifier_pctObligatorionumber-90..900, o -100 para excluir
customer_idOpcionalstringoptional: 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éditos

Activa/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ámetroTipoDescripción
call_reportingOpcionalboolean—
call_conversionOpcionalboolean—
call_conversion_action_idOpcionalstring—
customer_idOpcionalstringoptional: 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éditos

Cambia 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ámetroTipoDescripción
asset_group_idObligatoriostring—
final_urlOpcionalstring—
nameOpcionalstring—
statusOpcionalENABLED | PAUSED | REMOVED—
path1Opcionalstring—
path2Opcionalstring—
customer_idOpcionalstringoptional: 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.