Os Anúncios do Google Linguagem de Consulta pode consultar o Google API de Anúncios para
Recursos e seus atributos relacionados, segmentos e métricas usando GoogleAdsService
Procurar ou SearchStream O resultado de um GoogleAdsService consulta é uma lista deGoogleAdsRow
instâncias, com cada GoogleAdsRow
representa um recurso. Se quaisquer atributos ou métricas são solicitados, então therow também inclui esses campos., Se quaisquer segmentos são solicitados, então theresponse também mostra uma linha adicional para cada parcela-recurso. Metadados sobre campos e recursos disponíveis em GoogleAdsFieldService
este serviço fornece um catálogo de campos que podem ser pesquisados com detalhes sobre sua compatibilidade e tipo.
o resultado de um id
query é uma lista de instâncias
, com cada ID
contendo detalhes sobre o campo solicitado.,
questionar atributos de um recurso
abaixo é uma consulta básica para atributos do recurso da campanha, ilustrando howto return campaign ID, nome e estado:
SELECT campaign.id, campaign.name, campaign.statusFROM campaignORDER BY campaign.id
Esta consulta orders by campaign ID. Cada um resultante GoogleAdsRow
representariacampaign
objeto povoado com os campos selecionados (incluindo que givencampaign’sresource_name
).
para saber quais os outros campos disponíveis para consultas de campanha, consulte a documentação de referênciaCampaign
.,
Consultar métricas
ao Lado de atributos selecionados para um determinado recurso, você também pode consultar forrelated métricas:
Esta consulta filtra apenas as campanhas que têm um status de PAUSED
andhave tinha maior que 1000 impressões, enquanto ordenação por ID da campanha. Eachresulting GoogleAdsRow
teria um metrics
campo preenchido com o métricas.
para uma lista de métricas que podem ser pesquisadas, consulte a Metrics
documentação.,
Consulta por segmentos
ao Lado de atributos selecionados para um determinado recurso, você também pode consultar forrelated segmentos:
Semelhante para consultar métricas, esta consulta filtra apenas as campanhas thathave um estado de PAUSED
e tiveram maior que 1000 impressões; no entanto,esta consulta segmentos de dados por data. Isto leva a cada resultadoGoogleAdsRow
representando uma tupla de uma campanha e a dataSegment
. É importante notar que a segmentação divide as métricas seleccionadas, agrupando-as por cada segmento na cláusula de selecção.,
para uma lista de segmentos que podem ser consultados, consulte a documentação Segments
.
em uma consulta para um determinado recurso, você pode ser capaz de se juntar a outros recursos relacionados, se disponível. Estes recursos relacionados são conhecidos como”recursos atribuídos”. Você pode se juntar contra recursos atribuídos implicitamente selecionando anatntribute em sua consulta.
SELECT campaign.id, campaign.name, campaign.status, bidding_strategy.nameFROM campaignORDER BY campaign.id
esta consulta não só selecciona atributos da campanha, como também atrai atributos relacionados de cada campanha seleccionada., Cada um resultante GoogleAdsRow
representsacampaign
objecto povoado com os Atributos Seleccionados da campanha, bem como o atributo seleccionado da estratégia de licitaçãobidding_strategy.name
.
para saber quais os recursos atribuídos disponíveis para as consultas de campanha,consulte a documentação de referência Campaign
.
mutação com base nos resultados da consulta
ao questionar um dado recurso, pode imediatamente tomar os resultados retornados como objectos, modificá-los e enviá-los de volta para o método de mutação no serviço da thatresource., Abaixo está um fluxo de trabalho de amostra:
- Execute uma consulta para todas as campanhas que são atualmente
PAUSED
e temimpressões superiores a 1000. - Get the
Campaign
object from thecampaign
field of eachGoogleAdsRow
na resposta. - altera o estado de cada campanha de
PAUSED
paraENABLED
. - Call
CampaignService.MutateCampaigns
com as campanhas modificadas para atualizá-las.,
metadados de campo
As consultas enviadas para GoogleAdsFieldService
destinam-se a obter metadados de campo.Esta informação pode ser usada para entender como os campos podem ser usados em conjunto em uma consulta. Uma vez que os dados estão disponíveis A partir da API e que ela fornece a necessarymetadata necessária para validar ou construir uma consulta, Isso permite que os desenvolvedores de doso programaticamente. Aqui está a pesquisa atípica para metadados:
para uma lista de campos que podem ser pesquisados, consulte a documentação
.,
exemplos de código
as bibliotecas-clientes têm exemplos de usar a linguagem de consulta Ads do groogle emGoogleAdsService
. As operações básicas pasta hasexamples como GetCampaigns
GetKeywords
e GetArtifactMetadata
.A pasta de relatórios tem um exemplo GetKeywordStats
.