El lenguaje de consulta de Google Ads puede consultar la API de Google Ads para obtener recursos
y sus atributos, segmentos y métricas relacionados utilizando GoogleAdsService Search o SearchStream el resultado de una consulta de GoogleAdsService es una lista de instanciasGoogleAdsRow, con cada GoogleAdsRowque representa un recurso. Si se solicitan atributos o métricas, therow también incluye esos campos., Si se solicita algún segmento, entonces theresponse también muestra una fila adicional para cada tupla segmento-recurso. Metadatos sobre los campos y recursos disponibles en GoogleAdsFieldService
Este servicio proporciona un catálogo de campos consultables con detalles sobre su compatibilidad y tipo.
El resultado de un GoogleAdsFieldService consulta es una lista deGoogleAdsField instancias, con cadaGoogleAdsField que contiene detalles sobre el área solicitada.,
consulta de atributos de un recurso
a continuación se muestra una consulta básica de atributos del recurso de campaña, que ilustra cómo devolver el ID de campaña, el nombre y el estado:
SELECT campaign.id, campaign.name, campaign.statusFROM campaignORDER BY campaign.id esta consulta ordena por ID de campaña. Cada objeto resultante GoogleAdsRow representaría campaign poblado con los campos seleccionados (incluyendo el resource_namede esa campaña).
para averiguar qué otros campos están disponibles para las consultas de campaña, consulte la documentación de referenciaCampaign.,
consulta de métricas
junto con los atributos seleccionados para un recurso determinado, también puede consultar métricas relacionadas:
esta consulta se filtra solo para las campañas que tienen un estado de PAUSED y han tenido más de 1000 impresiones, al Ordenar por ID de campaña. Cada consulta GoogleAdsRow tendría un campo metrics rellenado con las métricas seleccionadas.
para obtener una lista de métricas consultables, consulte la documentación Metrics.,
consulta de segmentos
junto con los atributos seleccionados para un recurso determinado, también puede consultar segmentos relacionados:
Similar a la consulta de métricas, esta consulta se filtra solo para las campañas que tienen un estado de PAUSED y han tenido más de 1000 impresiones; sin embargo,esta consulta segmenta los datos por fecha. Esto lleva a cada resultadoGoogleAdsRow que representa una tupla de una campaña y la fecha Segment. Es importante tener en cuenta que la segmentación divide las métricas seleccionadas, agrupándolas por cada segmento en la cláusula SELECT.,
para obtener una lista de segmentos consultables, consulte la documentación Segments.
en una consulta para un recurso dado, puede ser capaz de unirse contra otros recursos relacionados si está disponible. Estos recursos relacionados se conocen como»recursos atribuidos». Puede unirse contra recursos atribuidos implícitamente seleccionando anattribute en su consulta.
SELECT campaign.id, campaign.name, campaign.status, bidding_strategy.nameFROM campaignORDER BY campaign.idEsta consulta no solo selecciona los atributos de la campaña, sino que también extrae los atributos relacionados de cada campaña seleccionada., Cada objeto resultanteGoogleAdsRow representa uncampaign rellenado con los atributos de campaña seleccionados, así como el atributo de estrategia de ofertas seleccionadobidding_strategy.name.
para averiguar qué recursos atribuidos están disponibles para las consultas de campaña,consulte la documentación de referencia Campaign.
mutar en función de los resultados de la consulta
al consultar un recurso determinado, puede tomar inmediatamente esos resultados devueltos como objetos, modificarlos y enviarlos de vuelta al método mutate en el servicio de ese recurso., A continuación se muestra un flujo de trabajo de ejemplo:
- ejecutar una consulta para todas las campañas que son actualmente
PAUSEDy tienen impresiones mayores de 1000. - obtenga el objeto
Campaigndel campocampaignde cadaGoogleAdsRowen la respuesta. - Cambiar el estado de cada campaña de
PAUSEDaENABLED. - llama a
CampaignService.MutateCampaignscon las campañas modificadas para actualizarlas.,
metadatos de campo
Las consultas enviadas a GoogleAdsFieldService están destinadas a recuperar metadatos de campo.Esta información se puede utilizar para entender cómo los campos se pueden utilizar juntos en una consulta. Dado que los datos están disponibles desde la API y proporcionan la información necesaria para validar o crear una consulta, esto permite a los desarrolladores doso mediante programación. Aquí está la consulta atípica de metadatos:
para obtener una lista de campos consultables, consulte la documentación GoogleAdsField.,
ejemplos de Código
Las bibliotecas cliente tienen ejemplos de uso del lenguaje de consulta de Google Ads en GoogleAdsService. Las operaciones básicas de la carpeta hasexamples como GetCampaigns, GetKeywords y GetArtifactMetadata.La carpeta de informes tiene un ejemplo GetKeywordStats.
