Anúncios do Google Linguagem de Consulta

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 GoogleAdsRowrepresenta 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 Metricsdocumentaçã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:

  1. Execute uma consulta para todas as campanhas que são atualmente PAUSED e temimpressões superiores a 1000.
  2. Get the Campaign object from the campaign field of eachGoogleAdsRow na resposta.
  3. altera o estado de cada campanha dePAUSED paraENABLED.
  4. CallCampaignService.MutateCampaignscom 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.

Author: admin

Deixe uma resposta

O seu endereço de email não será publicado. Campos obrigatórios marcados com *