Recupera objetos

Objetivo: Comprender cómo recuperar objetos y estadísticas de rendimiento con GoogleAdsService Para los conceptos de informes, consulta las guías de informes.

GoogleAdsService es el objeto unificado. de recuperación y generación de informes de la API de Google Ads. El servicio tiene métodos que hacen lo siguiente:

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

GoogleAdsService puede mostrar resultados en dos maneras:

• GoogleAdsService.SearchStream devuelve todas las filas en una sola respuesta de transmisión, que es más eficiente para conjuntos de resultados grandes (más de 10,000 filas). Esto podría ser más apropiado si tu aplicación por lotes quiere descargar tantos datos tan rápido como como sea posible.
• GoogleAdsService.Search se interrumpe respuestas grandes en páginas de resultados manejables. Esto podría ser más adecuado si tu aplicación interactiva muestra una página de resultados con una tiempo.

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

Haz una solicitud

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

• A customer_id
• Un query de lenguaje de consulta de Google Ads que indica qué recurso consultar, los atributos segmentos y métricas para recuperar, además de las condiciones que se deben usar para restringir qué objetos se devuelven
• (solo GoogleAdsService.Search) A page_size para indicar cuántos objetos mostrar en una sola respuesta cuando con Paging
• (Solo GoogleAdsService.Search) Un page_token opcional para recuperar el siguiente lote de resultados cuando se usa Paging.

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

Cómo procesar una respuesta

GoogleAdsService muestra una lista de Objetos GoogleAdsRow.

Cada GoogleAdsRow representa un objeto que muestra una consulta y consta de un de atributos que se completan según los campos solicitados en la SELECT. Los atributos que no se incluyen en la cláusula SELECT no se incluyen propagado en los objetos GoogleAdsRow de la respuesta.

Por ejemplo, aunque un ad_group_criterion tiene un atributo status, el El campo status del atributo ad_group_criterion de la fila no se completa en una respuesta para una consulta en la que la cláusula SELECT no incluye ad_group_criterion.status De manera similar, el atributo campaign de la fila es no se completa si la cláusula SELECT no incluye ningún campo de la campaign recurso.

Cada GoogleAdsRow puede tener diferentes atributos y métricas de otra fila en el mismo conjunto de resultados; por lo que 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 en esa versión de la API. Estos recursos podrían haberse creado a través de otros interfaces, como la IU de Google Ads. Puedes seleccionar métricas cuando un recurso tiene un de UNKNOWN, pero no puedes mutar el recurso a través de la API. Los ejemplo de esto sería que se introdujera una nueva campaña o anuncio en la interfaz de usuario, pero no es compatible con la versión de la API que estás consultando.

Estas son algunas consideraciones que debes tener en cuenta:

• Un recurso con un tipo UNKNOWN se puede admitir más adelante o permanecer como UNKNOWN indefinidamente.
• Los objetos nuevos con el tipo UNKNOWN pueden aparecer en cualquier momento. Estos objetos se retrocompatible porque el valor enum ya está disponible. Recursos con este cambio, ya que están disponibles, de modo que tengas una vista precisa de tu cuenta. El recurso UNKNOWN puede aparecer debido a lo siguiente: nuevas actividades en tu cuenta a través de otras interfaces o cuando un recurso ya no se admite.
• UNKNOWN de recursos pueden tener métricas detalladas adjuntas que son consultables.
• 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ía un elemento GoogleAdsRow para cada combinación de lo siguiente:

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

Por ejemplo, la respuesta para una consulta que selecciona FROM campaign y tiene segments.ad_network_type y segments.date en la cláusula SELECT contienen una fila para cada combinación de los siguientes elementos:

• campaign
• segments.ad_network_type
• segments.date

Los resultados se segmentan de forma implícita por cada instancia del recurso principal, no por los valores de los campos individuales seleccionados. Por ejemplo:

SELECT campaign.status, metrics.impressions
FROM campaign
WHERE segments.date DURING LAST_14_DAYS

genera una fila por campaña, no una fila por cada valor distinto de la campaign.status.