Google ha lanzado una actualización de versión menor de la API de Google Ads, versión 23.1. Esta actualización tiene cambios en la administración de cuentas, campañas, conversiones, incentivos, planificación, informes y más.
Google escribió: «Para utilizar las nuevas funciones v23.1, debe actualizar las bibliotecas de cliente y el código de cliente. Se han publicado todas las bibliotecas de cliente y ejemplos de código actualizados. También estamos lanzando versiones menores v20.2, v21.1 y v22.1 de la API de Google Ads para agregar soporte adicional para el Reglamento de anuncios políticos de la UE».
Antes de este lanzamiento, estaba la versión 23 a finales de enero, luego la versión 22 el 15 de octubre de 2025, luego la versión 21 el 6 de agosto de 2025, luego la 20 el 5 de junio de 2025, la 19.1 en abril de 2025, luego la 19 en febrero de 2025, luego la versión 18 en octubre de 2024. Antes de eso, era la 17.1 en agosto de 2024 y luego, antes de eso, fue la versión 17.0 en junio de 2024 y luego, antes de eso, fue la versión 16.1 y luego la versión 16 en febrero de 2024. Antes de eso, fue la versión 15 en octubre de 2023. Luego, antes de eso, fue la versión 14.1 que se lanzó en agosto. La versión 13.1 precedió a esta nueva versión, que se lanzó en abril de 2023. La versión 12.0 se lanzó en octubre de 2022, la versión 11.0 de la API de Google Ads se lanzó en junio y la versión 11.1 en agosto. Además, la versión 10.1 se lanzó el 27 de abril de 2022 y la versión 10.0 se lanzó el 9 de febrero de 2022. Y Google suspendió la API de AdWords el 27 de abril, que dejará de funcionar por completo a finales de julio.
Aquí están las notas de la versión:
Gestión de cuentas
- Se agregó publicidad_partner_properties.allowed_domain a los recursos ProductLinkInvitation y ProductLink. El socio publicitario sólo podrá anunciar en este dominio.
- Se agregó el campo contains_eu_political_advertising al recurso Cliente. Este campo recupera el estado de la declaración a nivel de cuenta sobre si contiene publicidad política dirigida a la UE y devuelve un EuPoliticalAdvertisingStatusEnum.
Campañas
- Se agregó compatibilidad con pautas de texto, que se pueden usar con campañas Máximo rendimiento y de búsqueda para controlar mediante programación los recursos de texto generados por IA.
- Se agregó el campo Campaign.text_guidelines al recurso Campaña.
- Dentro de text_guidelines, puede definir term_exclusions y message_restrictions.
- Se agregaron CampaignPrimaryStatusReason.CAMPAIGN_NOT_BOOKED, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRING, CampaignPrimaryStatusReason.BOOKING_HOLD_EXPIRED y CampaignPrimaryStatusReason.BOOKING_CANCELLED para proporcionar motivos de estado principales para campañas con la estrategia de oferta de FIXED_CPM.
- Se agregaron Campaign.VideoCampaignSettings.reservation_ad_category_self_disclosure y Campaign.VideoCampaignSettings.booking_details (solo lectura).
- Se agregó Campaign.missing_eu_political_advertising_declaration para admitir la consulta y el filtrado de campañas a las que les faltan declaraciones sobre si contienen publicidad política dirigida a la UE.
Conversiones
- Se agregó ConversionActionCategory.YOUTUBE_FOLLOW_ON_VIEWS para permitir el seguimiento de los usuarios que ven un anuncio y luego ven un video del mismo canal.
General
- Se agregó CANNOT_TARGET_ONLY_UNDETERMINED a CriterionErrorEnum. Este error se devuelve cuando se intenta orientar la publicidad solo a la categoría indeterminada en las dimensiones demográficas.
Incentivos
- Se agregaron dos nuevos códigos de error a IncentiveErrorEnum: MAX_INCENTIVES_REDEEMED y ACCOUNT_TOO_OLD. Estos errores se pueden devolver para solicitudes realizadas a partir del 11 de marzo de 2026.
Planificación
- Se agregó soporte para desgloses de fechas en GenerateBenchmarksMetrics usando BreakdownDefinition.
- Se agregó GOOGLE_DISPLAY_NETWORK como superficie objetivo para Conversiones máximas de generación de demanda en ReachPlanService.GenerateReachForecast.
- Se agregó información de línea de tendencia histórica en TrendInsightDataPoint a TrendInsights en GenerateTrendingInsights al buscar por tema.
Informes
- Se agregaron nuevas métricas que informan cuántos usuarios vieron su anuncio al menos dos, tres, cuatro, cinco o diez veces: usuarios_únicos_dos_plus, usuarios_únicos_tres_plus, usuarios_únicos_cuatro_plus, usuarios_únicos_cinco_plus y usuarios_únicos_diez_plus.
- Se agregó VERTICAL_ADS_DATA_FEED a SearchTermMatchSourceEnum para admitir feeds de datos de anuncios verticales (por ejemplo, segmentación por entidades de anuncios de viajes).
YouTubeVideoSubir
- Se agregó el servicio YouTubeVideoUpload para admitir la carga y administración de videos en YouTube, y el recurso YouTubeVideoUpload para admitir la obtención del estado de carga y los metadatos. Esta característica solo es compatible con REST y la biblioteca cliente de Python.
Discusión del foro en X.
