De forma periódica, es posible que desees actualizar de una versión principal anterior de la API de Google Ads a una versión principal más reciente. Puede deberse a que una versión dejará de estar disponible o a que quieres usar una función nueva. Te recomendamos actualizar siempre a la versión más reciente.
Consulta nuestro programa de baja para planificar tus actualizaciones. Consulta nuestra guía sobre el control de versiones para descubrir cómo el control de versiones.
Esta es una lista de tareas para ayudarte a comenzar con el proceso de actualización:
- Tu extremo cambiará cuando cambies las versiones principales. Actualiza tus bibliotecas cliente para usar el extremo más reciente.
- Revisa las notas de la versión para ver los cambios que se introdujeron en cada versión.
- Consulta las siguientes tablas para conocer áreas específicas en las que debes enfocarte para esta versión a la que te estás actualizando.
Para obtener un resumen completo de los cambios basados en una diferencia entre los prototipos de consulta la tabla de diferencias.
De la versión 17 a la 18
| Cambios en los servicios y sus componentes | |
|---|---|
GoogleAdsService
Solicitudes Search y SearchStream |
El error que aparece cuando se limita tu solicitud porque es demasiado costosa
Puede ser
|
GoogleAdsService |
Los campos summary_row_setting y return_total_results_count de SearchGoogleAdsRequest ahora forman parte del nuevo objeto SearchSettings. |
AssetType |
Se cambió el nombre del valor de enumeración DISCOVERY_CAROUSEL_CARD a
DEMAND_GEN_CAROUSEL_CARD Esto está en línea con un cambio anterior para cambiar el nombre de las campañas discovery a campañas de generación de demanda. |
AudienceInsightsService.GenerateSuggestedTargetingInsights |
Los campos audience, baseline_audience y data_month se movieron dentro del campo audience_definition. |
DemandGenCampaignSettings |
Ahora, el valor predeterminado para el campo upgraded_targeting es
true en lugar de false. |
LocalServicesLeadConversation |
El campo phone_call_details.call_recording_url ya no se propagará para las llamadas estáticas. |
De la versión 16 a la 17
| Cambios en los servicios y sus componentes | |
|---|---|
GoogleAdsService
Solicitudes Search y SearchStream |
Es posible que se limite tu solicitud si la consulta es demasiado costosa. De lo contrario, recibirás un error |
GoogleAdsService
Search. |
Si pasas un |
Campaign y Ad |
Las campañas con un Además, algunos anuncios cambiarán el tipo y los nombres de los campos de los informes:
|
AdService |
Se quitará el extremo GetAd. Esto lleva al
AdService de acuerdo con otros servicios de la API de Google Ads. Consulta nuestra
guía sobre la recuperación
objetos para obtener la forma recomendada de recuperar anuncios y otros tipos de recursos. |
CustomerLifecycleGoal
y CampaignLifecycleGoal |
Se modificó la manera de administrar segmentos para los objetivos del ciclo de vida. Consulta la sección Segmenta tus públicos de la documentación de los objetivos del ciclo de vida para obtener una descripción general completa. |
ProductLink |
Cuando ejecutas una búsqueda de GoogleAdsService o una solicitud de flujo de búsqueda para product_link, ahora solo puedes seleccionar campos relacionados con un producto vinculado. Si seleccionas varios campos de diferentes productos vinculados, se generará un error QuotaError.PROHIBITED_FIELD_COMBINATION_IN_SELECT_CLAUSE. |
| Informes | Se cambió el nombre del campo metrics.sk_ad_network_conversion_value a metrics.sk_ad_network_fine_conversion_value. |