Cómo recuperar objetos

El GoogleAdsService es el servicio unificado de informes y recuperación de objetos de la API de Google Ads. El servicio tiene métodos que:

• Recupera atributos específicos de objetos.
• Recupera métricas de rendimiento de objetos según un período.
• Ordena los objetos según sus atributos.
• Usa condiciones para indicar qué objetos quieres que se muestren en la respuesta.
• Limita la cantidad de objetos que se muestran.

GoogleAdsService puede mostrar resultados de dos maneras:

• GoogleAdsService.SearchStream muestra todas las filas en una sola respuesta de transmisión, que es más eficiente para conjuntos de resultados grandes (de más de 10,000 filas). Esto puede ser más apropiado si tu aplicación por lotes desea descargar tantos datos lo más rápido posible.
• GoogleAdsService.Search dividirá las respuestas grandes en páginas de resultados administrables. Esto puede ser más apropiado si tu aplicación interactiva muestra una página de resultados a la vez.

Obtén más información sobre la paginación frente a la transmisión.

Cómo realizar una solicitud

El método de búsqueda requiere un SearchGoogleAdsRequest, que consta de los siguientes atributos:

• Un objeto customer_id.
• Un query del lenguaje de consulta de Google Ads que indica qué recurso consultar, los atributos, segmentos y métricas que se deben recuperar, y las condiciones que se deben usar para restringir los objetos que se muestran
• Un objeto page_size (solo GoogleAdsService.Search) para indicar cuántos objetos se deben mostrar en una sola respuesta cuando se usa la paginación.
• Un objeto page_token opcional para recuperar el siguiente lote de resultados cuando se usa la paginación (solo GoogleAdsService.Search).

Para obtener más información sobre el lenguaje de consulta de Google Ads, consulta la guía del lenguaje de consulta de Google Ads.

Procesa una respuesta

GoogleAdsService muestra una lista de objetos GoogleAdsRow.

Cada GoogleAdsRow representa un objeto que muestra una consulta y consta de un conjunto de atributos que se propagan en función de los campos solicitados en la cláusula SELECT. Los atributos no incluidos en la cláusula SELECT no se propagan en los objetos GoogleAdsRow de la respuesta.

Por ejemplo, aunque un ad_group_criterion tenga un atributo status, el campo status del atributo ad_group_criterion de la fila no se propaga en una respuesta para una consulta en la que la cláusula SELECT no incluye ad_group_criterion.status. Del mismo modo, el atributo campaign de la fila no se propaga si la cláusula SELECT no incluye ningún campo del recurso campaign.

Cada GoogleAdsRow puede tener atributos y métricas diferentes de otra fila en el mismo conjunto de resultados; por lo tanto, las filas deben verse como objetos en lugar de filas fijas de una tabla.

Tipos de enumeración UNKNOWN

Los recursos que se muestran con un tipo de UNKNOWN no son totalmente compatibles con esa versión de la API. Estos recursos pueden haberse creado a través de otras interfaces, como la IU de Google Ads. Puedes seleccionar métricas cuando un recurso tenga un tipo de UNKNOWN, pero no puedes mutar el recurso a través de la API. Un ejemplo de esto sería una campaña o un anuncio nuevos que se presentan en la IU, pero no se admiten en la versión de la API que estás consultando.

Debes tener en cuenta lo siguiente:

• Un recurso con un tipo UNKNOWN puede ser compatible más adelante o permanecer UNKNOWN de forma indefinida.
• Los objetos nuevos con el tipo UNKNOWN pueden aparecer en cualquier momento. Estos objetos son retrocompatibles porque el valor enum ya está disponible. Presentamos recursos con este cambio a medida que están disponibles para que tengas una vista precisa de tu cuenta. Es posible que aparezca el recurso UNKNOWN debido a la nueva actividad de tu cuenta a través de otras interfaces o porque un recurso ya no es compatible formalmente.
• Los recursos UNKNOWN pueden tener métricas detalladas adjuntas que puedes consultar.
• Los recursos de UNKNOWN suelen estar completamente visibles en la IU de Google Ads.
• Por lo general, los recursos UNKNOWN no se pueden mutar.

Segmentación

La respuesta contendrá un GoogleAdsRow para cada combinación de las siguientes opciones:

• instancia del recurso principal especificado en la cláusula FROM
• valor de cada campo segment seleccionado

Por ejemplo, la respuesta de una consulta que selecciona FROM campaign y tiene segments.ad_network_type y segments.date en la cláusula SELECT contendrá una fila por cada combinación de lo siguiente:

• campaign
• segments.ad_network_type
• segments.date