GoogleAdsService
es el servicio unificado de recuperación y generación de objetos de la API de Google Ads. El servicio tiene métodos que:
- Recupera atributos específicos de objetos.
- Recuperar las métricas de rendimiento de los objetos en función de un período
- Ordena 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 (más de 10,000). Esto puede ser más adecuado si tu aplicación por lotes quiere descargar la mayor cantidad de datos posible.GoogleAdsService.Search
dividirá las respuestas grandes en páginas de resultados fáciles de administrar. 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 en comparación con 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
de Google Ads Query Language que indica qué recurso se debe consultar, los atributos, los segmentos y las métricas que se deben recuperar, y las condiciones que se deben usar para restringir los objetos que se muestran. - (Solo
GoogleAdsService.Search
) Unpage_size
para indicar cuántos objetos mostrar en una sola respuesta cuando se usa la paginación. - (Solo
GoogleAdsService.Search
) Es unpage_token
opcional para recuperar el siguiente lote de resultados cuando uses la paginación.
Para obtener más información sobre el lenguaje de las consultas de Google Ads, consulta la Guía de lenguaje de consultas de Google Ads.
Cómo procesar una respuesta
El objeto GoogleAdsService
muestra una lista de objetos GoogleAdsRow
.
Cada GoogleAdsRow
representa un objeto que muestra una consulta y consiste en un conjunto de atributos que se propagan según los campos solicitados en la cláusula SELECT
. Los atributos que no están incluidos 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 propaga en una respuesta para una búsqueda 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 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. 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 mutarlo a través de la API. Un ejemplo de esto sería una campaña nueva o un anuncio nuevo que se introduce en la IU, pero no se admite en la versión de la API que consultas.
A continuación, indicamos algunos aspectos que debe tener en cuenta:
- Un recurso con un tipo
UNKNOWN
puede ser compatible más adelante o mantenerseUNKNOWN
indefinidamente. - Los objetos nuevos con el tipo
UNKNOWN
pueden aparecer en cualquier momento. Estos objetos son compatibles con versiones anteriores porque el valor enum ya está disponible. Incorporamos recursos con este cambio a medida que están disponibles para que tengas un panorama preciso de tu cuenta. El recursoUNKNOWN
puede aparecer debido a la actividad nueva en tu cuenta a través de otras interfaces o porque un recurso ya no es compatible formalmente. - Es posible que los recursos
UNKNOWN
tengan métricas detalladas adjuntas que puedes consultar. - En general, los recursos
UNKNOWN
son completamente visibles en la IU de Google Ads. - Por lo general, no se pueden mutar los recursos de
UNKNOWN
.
Segmentación
La respuesta contendrá un GoogleAdsRow
para cada combinación de los siguientes elementos:
- instance 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 para cada combinación de los siguientes elementos:
campaign
segments.ad_network_type
segments.date