Actualiza a la versión más reciente

Periódicamente, es posible que desees actualizar desde una versión principal anterior de la API de Google Ads a una versión principal más reciente. Esto puede deberse a que una versión se desactiva o a que 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 tus actualizaciones. Consulta nuestra guía de control de versiones para obtener información sobre su funcionamiento.

A continuación, le mostramos una lista de verificación que lo ayudará a comenzar con el proceso de actualización:

  1. Tu extremo cambiará cuando cambies las versiones principales. Actualiza tus bibliotecas cliente para usar el extremo más reciente.
  2. Consulta las notas de la versión para ver los cambios que se agregaron en cada versión.
  3. Consulta las siguientes tablas para conocer las á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 15 a la 16

Cambios en los servicios y sus componentes
AccountLink Se quitaron los vínculos data_partner y google_ads en linked_account. En su lugar, usa ProductLinkService y ProductLinkInvitationService.
CampaignLifecycleGoal Antes, cuando se actualizaba un CampaignLifecycleGoal existente, se emitiría una operación create con requisitos específicos. Ahora puedes emitir una operación update como con otros tipos de recursos.
Error Reporting Dos casos en los que se mostró el error ContextError.OPERATION_NOT_PERMITTED_FOR_CONTEXT genérico ahora generan mensajes de error más específicos:
  • CampaignError.CANNOT_LINK_TO_COMPARISON_SHOPPING_SERVICE_ACCOUNT
  • CampaignError.CANNOT_TARGET_NETWORK_FOR_COMPARISON_SHOPPING_SERVICE_LINKED_ACCOUNTS
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 15

Cambios en los servicios y sus componentes
AssetGroupListingGroupFilter Se cambió el nombre del campo de enumeración vertical por 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 Se reemplazó el servicio por ProductLinkInvitationService y ProductLinkService.
Campaign.ShoppingSetting Se quitó el campo sales_country. La información ahora 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 segmentos:
  • product_bidding_category_level1
  • product_bidding_category_level2
  • product_bidding_category_level3
  • product_bidding_category_level4
  • product_bidding_category_level5
se reemplazaron por:
  • product_category_level1
  • product_category_level2
  • product_category_level3
  • product_category_level4
  • product_category_level5
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 desde:

SELECT customer.offline_conversion_client_summaries
FROM customer
a: 
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 a fin de 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 enum: YOUTUBE.