GoogleAdsService
es el servicio unificado de recuperación y generación de informes de objetos de la API de Google Ads. El servicio tiene métodos que realizan las siguientes acciones:
- Recupera atributos específicos de objetos.
- Recupera las métricas de rendimiento de los objetos según un período.
- Ordenar 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 devuelven.
El método GoogleAdsService
puede devolver resultados de dos maneras:
GoogleAdsService.SearchStream
devuelve todas las filas en una sola respuesta de transmisión, lo que es más eficiente para los conjuntos de resultados grandes (más de 10,000 filas). Esto podría ser más adecuado si tu aplicación por lotes quiere descargar la mayor cantidad de datos posible lo más rápido posible.GoogleAdsService.Search
divide las 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 a la vez.
Obtén más información sobre la paginación en comparación con la transmisión.
Haz una solicitud
El método de búsqueda requiere un SearchGoogleAdsRequest
, que consta de los siguientes atributos:
- A
customer_id
- Un objeto
query
del lenguaje de búsqueda de Google Ads que indica qué recurso consultar, los atributos, los segmentos y las métricas que se recuperarán, y las condiciones que se usarán para restringir los objetos que se devuelven - (Solo para
GoogleAdsService.Search
) Es unpage_token
opcional para recuperar el siguiente lote de resultados cuando se usa la paginación.
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
devuelve una lista de objetos GoogleAdsRow
.
Cada GoogleAdsRow
representa un objeto que devuelve una búsqueda y consta de un conjunto de atributos que se completan según los campos solicitados en la cláusula SELECT
. Los atributos que no se incluyen en la cláusula SELECT
no se propagan en los objetos GoogleAdsRow
de la respuesta.
Por ejemplo, aunque un ad_group_criterion
tiene un atributo status
, 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
. 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 diferentes atributos y métricas que otra fila del 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 se admiten por completo en esa versión de la API. Es posible que estos recursos se hayan creado a través de otras interfaces, como la IU de Google Ads. Puedes seleccionar métricas cuando un recurso tiene 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 introducen en la IU, pero que no se admiten en la versión de la API que consultas.
Estos son algunos factores que debes tener en cuenta:
- Un recurso con un tipo
UNKNOWN
puede admitirse más adelante o permanecerUNKNOWN
de forma indefinida. - Pueden aparecer objetos nuevos con el tipo
UNKNOWN
en cualquier momento. Estos objetos son retrocompatibles porque el valor de enumeración ya está disponible. Con este cambio, se introducen los recursos a medida que están disponibles para que tengas una vista precisa de tu cuenta. El recursoUNKNOWN
puede aparecer debido a actividades nuevas en tu cuenta a través de otras interfaces o cuando un recurso ya no es compatible. - Los recursos de
UNKNOWN
pueden tener métricas detalladas adjuntas que se pueden consultar. - Por lo general, los recursos de
UNKNOWN
son completamente visibles en la IU de Google Ads. - Por lo general, los recursos de
UNKNOWN
no se pueden modificar.
Segmentación
La respuesta contendría un GoogleAdsRow
para cada combinación de los siguientes elementos:
- Instancia del recurso principal especificado en la cláusula
FROM
- Valor de cada campo
segment
seleccionado
Por ejemplo, la respuesta para una búsqueda que selecciona FROM campaign
y tiene segments.ad_network_type
y segments.date
en la cláusula SELECT
contendría una fila para cada combinación de lo siguiente:
campaign
segments.ad_network_type
segments.date
Los resultados se segmentan de forma implícita según cada instancia del recurso principal, no según 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 del campo campaign.status
.