Cambios en el flujo de trabajo en la API de Google Ads

Algunos de los flujos de trabajo generales de la API de AdWords se modifican en la API de Google Ads. Por ejemplo, para buscar entidades ahora se usa un servicio independiente de mutación.

Nombres de campos

En la API de AdWords, había campos separados para conceptos similares en diferentes entidades, como CampaignId y AdGroupId. En la API de Google Ads, ahora se usan los nombres de campo anidados, por ejemplo, campaign.id y ad_group.id. También puedes anidar más, por ejemplo, ad_group.campaign.id.

Casos de uso de servicios

En la API de AdWords, todas las operaciones de un tipo de entidad determinado utilizaron el mismo servicio. Se usó CampaignService para obtener (que incluía búsqueda y filtrado) y mutar.

En la API de Google Ads, la búsqueda usa su propio servicio, GoogleAdsService. Si necesitas una lista de entidades que coinciden con algunos criterios, siempre usa este servicio para encontrar una lista de resultados. Al igual que en la API de AdWords, las llamadas a este servicio propagan solo los campos solicitados de manera específica en la respuesta.

Aún existen solicitudes de Get en la API de Google Ads, en cada servicio específico de la entidad. Puedes obtener información de la campaña en CampaignService. Sin embargo, esta llamada cumple un propósito diferente al de la llamada en la API de AdWords. No puedes filtrar como parte de una solicitud get, sino obtener todos los detalles de una entidad especificada. El nombre del recurso de la entidad se pasa como un identificador, y la respuesta incluye todos los campos completados sin necesidad de enumerarlos todos.

Las solicitudes silenciadas en la API de Google Ads también están en el servicio específico de la entidad. Puedes modificar una entidad por operación y pasar varias operaciones en una misma solicitud, al igual que en la API de AdWords.

Informes

En la API de AdWords, los informes se mantenían completamente separados de los de otros servicios. En la API de Google Ads, esto ya no es así. Usa GoogleAdsService (lo mismo que se usa para buscar entidades) y simplemente incluye los campos de estadísticas en tu solicitud a fin de generar informes.

Otras diferencias clave entre los informes de la API de AdWords y la de la API de Google Ads son las siguientes:

  • En lugar de tipos de informes en la API de AdWords, tiene recursos como campaign y vistas de recursos, como keyword_view en la API de Google Ads.
  • Los informes de la API de Google Ads no muestran texto sin formato ni XML. En cambio, los métodos Search y SearchStream de GoogleAdsService muestran GoogleAdsRows que contienen objetos. Por ejemplo, cuando recuperes campaign.id, campaign.name y metrics.clicks, recuperarás un GoogleAdsRow que contenga un objeto de campaña con sus campos id y name configurados, así como un objeto metrics con su campo clicks establecido.
  • Las filas para cero impresiones se muestran de forma predeterminada en la API de Google Ads. No hay ningún parámetro includeZeroImpressions. Si deseas excluir cero filas de impresiones, usa un predicado como metrics.impressions > 0 en tu lenguaje de consulta de Google Ads.
  • GoogleAdsFieldService es similar a la API de AdWords ReportDefinitionService, pero en lugar de mostrar metadatos para los tipos de informes, muestra metadatos para los recursos y las vistas de recursos.
  • Si el valor de denominador es cero para un campo de proporción, como el costo por conversión, la API de AdWords muestra un valor de 0. En este caso, la API de Google Ads mostrará un valor nulo para que coincida con el comportamiento en la IU de Google Ads.
  • En lugar de tener informes de atribución únicos, que pueden contener varios tipos de criterios en un solo informe, la API de Google Ads se basa en diferentes vistas de informes para recuperar estadísticas relacionadas con diferentes tipos de criterios. Por ejemplo, puedes usar el keyword_view para recuperar datos por palabra clave o el product_group_view a fin de recuperar datos por grupo de productos. Por lo tanto, ya no hay un informe genérico que contenga varios tipos de criterios; solo puedes obtener estadísticas de un tipo de criterio en su vista.