Periódicamente, es posible que desees actualizar de una versión principal anterior de la API de Google Ads a una versión principal más nueva. Puede ser porque una versión se está descontinuando o porque quieres usar una función nueva. Te recomendamos que siempre actualices a la versión más reciente.
Consulta nuestro programa de baja para planificar las actualizaciones. Consulta nuestra guía sobre el control de versiones para obtener información sobre su funcionamiento.
A continuación, se incluye una lista de tareas para ayudarlo a comenzar 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 agregaron en cada versión.
- Consulta las siguientes tablas a fin de conocer áreas específicas en las que debes enfocarte para la versión a la que deseas actualizar.
Para obtener una descripción general completa de los cambios basados en una diferencia entre los protocolos de las dos versiones, consulta la tabla de diferencias.
De la versión 16 a la v17
| Cambios en los servicios y sus componentes | |
|---|---|
Solicitudes GoogleAdsService
Search y SearchStream |
Cuando se limita tu solicitud porque es demasiado costosa, el error que se produce será |
Solicitudes 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. De esta manera, el AdService se alinea con otros servicios de la API de Google Ads. Consulta nuestra guía sobre cómo recuperar objetos para conocer 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 Cómo segmentar tus públicos en la documentación de los objetivos del ciclo de vida para obtener una descripción general completa. |
ProductLink |
Cuando ejecutas una solicitud de búsqueda o flujo de búsqueda de GoogleAdsService 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. |
| Reporte | Se cambió el nombre del campo metrics.sk_ad_network_conversion_value a metrics.sk_ad_network_fine_conversion_value. |
De la versión 15 a la v16
| Cambios en los servicios y sus componentes | |
|---|---|
AccountLink |
Se quitaron los vínculos data_partner y google_ads de linked_account. En su lugar, usa ProductLinkService y ProductLinkInvitationService. |
CampaignLifecycleGoal |
Antes, cuando se actualizaba un CampaignLifecycleGoal existente, emites una operación create con requisitos específicos.
Ahora puedes emitir una operación update como con otros tipos de recursos en su lugar. |
| Informe de errores | Dos casos en los que se mostró el error ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT genérico ahora dan como resultado mensajes de error más específicos:
|
AudienceInsightsAttributeMetadata |
Se quitó el campo score. |
KeywordMatchTypeRecommendation |
Si no se establece el tipo de concordancia de palabras clave, la API ahora muestra UNSPECIFIED en lugar de UNKNOWN para el campo recommended_match_type. |
De la versión 14 a la v15
| Cambios en los servicios y sus componentes | |
|---|---|
AssetGroupListingGroupFilter
|
Se cambió el nombre del campo enum vertical a feed_type.
|
MediaFileService
|
Se quitó el servicio porque ya no es necesario.
Consulta el cambio de ImageAdInfo a continuación.
|
ImageAdInfo
|
El campo media_file se reemplazó por image_asset.
|
MerchantCenterLinkService
|
El servicio se reemplazó por
ProductLinkInvitationService y
ProductLinkService.
|
Campaign.ShoppingSetting
|
Se quitó el campo sales_country. Ahora, la información se muestra en el campo feed_label.
|
ProductBiddingCategoryConstant
|
Se reemplazó por
ProductCategoryConstant.
Se cambió el nombre de varios campos según corresponda. Consulta los tres cambios siguientes a continuación.
|
ListingDimensionInfo
|
Se reemplazó el campo product_bidding_category por product_category.
|
ListingGroupFilterDimension
|
Se reemplazó el campo product_bidding_category por product_category.
|
Informe de shopping_performance_view |
Los siguientes campos de segmento:
|
Campaign.shopping_setting
|
Se quitó la compatibilidad para crear campañas de Búsqueda con este campo. |
CampaignCriterion.listing_scope
|
Se quitó la compatibilidad para crear campañas de Búsqueda con este campo. |
Informe de sk_ad_network_conversions |
Se reemplazó metrics.sk_ad_network_conversions por metrics.sk_ad_network_installs.
|
OfflineConversionClientSummary
|
Se movió el campo offline_conversion_client_summaries de Customer a un recurso de nivel superior que puedes consultar por separado.
Cambia tu consulta de: SELECT customer.offline_conversion_client_summaries FROM customera: SELECT offline_conversion_upload_client_summary.client, offline_conversion_upload_client_summary.status, offline_conversion_upload_client_summary.total_event_count, offline_conversion_upload_client_summary.successful_event_count, offline_conversion_upload_client_summary.last_upload_date_time, ... FROM offline_conversion_upload_client_summary Usa el compilador de consultas para explorar la lista de campos disponibles para la selección y el filtrado. |
OfflineConversionUploadAlert
|
Se cambió el nombre a
OfflineConversionAlert |
OfflineConversionUploadError
|
Se cambió el nombre a
OfflineConversionError |
AdNetworkType
|
Las enumeraciones
YOUTUBE_SEARCH y
YOUTUBE_WATCH se combinaron en una sola:
YOUTUBE.
|